Argument list too long:参数撞上的那堵墙

凌晨两点,清理日志的脚本又报警了。你手动敲了一遍它失败的那条命令:

1cd /var/log/myapp
2rm *.log
3bash: /usr/bin/rm: Argument list too long

目录里的日志文件不算大,几百兆而已,磁盘也还有空间。你确认自己有权限,甚至 sudo rm *.log 也报同样的错。这看起来不像文件的问题,更像是 shell 突然不肯好好干活了。

其实这一刻,报错的既不是 shell 也不是 rm,而是内核。

通配符是 shell 展开的,账却算在 execve 头上

很多人以为 *.log 是 rm 自己解析的,其实不是。shell 在调用外部命令之前,会先把通配符展开成一长串文件名,再把它们作为 argv 数组交给 execve(2):

1argv[0] = "rm"
2argv[1] = "access.log"
3argv[2] = "access.log.1"
4...
5argv[100000] = "access.log.99998"

内核执行 execve 时,会把所有参数字符串加上所有环境变量字符串的总长度和一道上限比较,超过就返回 E2BIG,shell 把它翻译成那句熟悉的 Argument list too long。

所以关键不在单个文件名有多长,而在文件名的数量。当目录里积累了几万个日志文件,即便每个名字只有十几个字节,加起来也足够撞墙。

那道墙到底有多高

在 Linux 上,这道上限叫 ARG_MAX,可以直接问系统:

1$ getconf ARG_MAX
22097152

2 MB,这是绝大多数 x86_64 发行版的默认值。它的来历和进程栈有关:内核按栈大小(RLIMIT_STACK)的四分之一来算这个上限,同时设了一个下限,算出来的结果通常就是 2 MB 左右。

更直观的办法是让 xargs 自己报一遍,它会把环境变量占掉的部分也扣掉:

1$ xargs --show-limits </dev/null
2Your environment variables take up 3925 bytes
3POSIX upper limit on argument length (this system): 2097152
4POSIX smallest allowable upper limit on argument length (all systems): 4096
5Maximum length of command we could actually use: 2093227
6Size of command buffer we are actually using: 131072

注意最后两行:理论可用长度接近 2 MB,但 xargs 自己保守地只用了 128 KB 的缓冲区。这是它分批处理策略的一部分,后面会讲到。

还有一个容易忽略的 128 KB

ARG_MAX 管的是总长度,但内核对单个字符串还有一道更窄的门槛:MAX_ARG_STRLEN,大小是 32 个内存页,也就是 128 KB。哪怕你只传一个参数,只要它本身超过 128 KB,一样会被拒绝:

1$ big=$(python3 -c 'print("x"*200000)')
2$ echo "$big" > /dev/null      # 内建命令,没问题
3$ /bin/true "$big"
4bash: /bin/true: Argument list too long

总长度才 200 KB,远没到 2 MB,但单个参数已经越过了 128 KB。把大段文本(JSON、证书、脚本内容)塞进命令行参数时,就容易碰上这类问题。

绕过去的几种写法

知道原因之后,解法就清晰了:别让所有文件名同时挤进一个 argv。

1. 用 find 直接删

最干净的方式是根本不经过 execve 传参:

1find /var/log/myapp -name '*.log' -delete

-delete 是 find 自己逐个调用 unlink,参数列表里始终只有 find 那几个选项。顺带提醒一句,-delete 隐含了 -depth,也就是从叶子往回删,这通常是想要的行为。

2. 用 xargs 分批

如果删除前后还要做别的操作,把它交给 xargs:

1find /var/log/myapp -name '*.log' -print0 | xargs -0 rm

xargs 从标准输入读参数,按系统上限自动分批,一批一批地拼出命令执行。上面那个 --show-limits 里 128 KB 的缓冲区,就是它给自己留的安全余量——它宁可多跑几趟,也不愿意踩到 E2BIG。

-print0 和 -0 这对搭档一定要一起用。文件名里可能包含空格、换行甚至引号,用默认的换行分隔会把一个文件拆成好几个参数,反而制造新的麻烦。

3. 用 shell 循环逐个处理

数量不大、逻辑又特殊的时候,循环最稳妥:

1find /var/log/myapp -name '*.log' | while IFS= read -r f; do
2    gzip "$f" && rm -- "$f"
3done

这里 gzip 每次只拿到一个文件名,永远不会累积。加上 -- 是为了防止文件名以 - 开头被误当成选项。

环境变量也会掺和进来

因为环境变量和参数共享同一个预算,所以有时候命令本身短得不能再短,照样报错:

1$ export BIGVAR=$(head -c 2100000 /dev/zero | tr '\0' 'x')
2$ ls
3bash: /usr/bin/ls: Argument list too long
4$ env -i /bin/ls
5access.log  error.log  ...

ls 一个参数都没带,是那个 2 MB 的环境变量把额度占光了。用 env -i 从空环境启动就能验证。这种情况在 CI 里并不少见——某个步骤把整个配置文件或一段 Base64 塞进环境变量,后续所有命令就都开始报 E2BIG。

顺便说,单看 env | wc -c 得到的数字会偏小,因为环境变量在内存里是以 \0 分隔的,管道出来变成了换行,统计口径不完全一致,但它足够帮你发现“环境是不是异常膨胀了”。

一个快速排查清单

下次再撞上 Argument list too long,按这个顺序看:

  1. getconf ARG_MAX —— 确认这台机器的上限,容器里可能和宿主机不同。
  2. 数一下文件:find . -type f | wc -l —— 几万个文件时,通配符展开必然爆。
  3. env | wc -c —— 看环境变量是不是被谁撑大了。
  4. 检查单个参数 —— 用 ${#var} 看长度,超过 131072 就是撞上了 MAX_ARG_STRLEN。
  5. 把 rm *.log 换成 find ... -delete 或 xargs -0,先让流程跑通再回头清理源头。

通配符是个很好用的语法糖,但它不是免费的:展开发生在命令执行之前,所有文件名都要在内核那里过一次安检。理解了这一步,你就知道该怪的不是 rm,而是那个悄悄膨胀的 argv。

相关文章

参考文档

本文由 AI 辅助生成并经人工校验,如有疏漏欢迎指正。

[ COMMENTS ]

© 2026 AI 助手 · 码日新 · 每日文章_