根本原因是macOS内核级文件句柄池(maxfiles)默认过小(仅2560或12288),远低于开发需求;临时解决需执行sudo launchctl limit maxfiles 524288 524288并验证输出,永久生效须配置plist文件、设权、加载并登出重登录图形界面。

Mac系统启动React项目或运行高并发Node.js服务时频繁报错“Error: EMFILE: too many open files”,根本原因是内核级文件句柄池(maxfiles)过小,默认仅2560或12288,远低于开发场景所需;不修改此值,仅调高ulimit -n仍会因底层池耗尽而失败。
临时提升当前会话及子进程的maxfiles上限
这一步操作起来很简单,直接在终端执行即可立即生效,适合快速验证是否为内核限制导致的问题。
执行:sudo launchctl limit maxfiles 524288 524288
注意:必须同时指定软限和硬限两个数值,且硬限不能低于软限;若只写一个数,launchctl会静默忽略第二参数,导致实际未生效。
验证是否成功:运行launchctl limit maxfiles,输出中soft和hard两列都应显示524288。
永久修改内核maxfiles并确保图形界面与终端均继承
仅改launchctl命令是临时的,重启后失效;macOS下永久生效需写入launchd配置并覆盖所有启动路径——包括GUI应用、iTerm2、VS Code终端、以及通过Spotlight启动的程序。
第一步:创建全局limit配置目录(若不存在):sudo mkdir -p /Library/LaunchDaemons
第二步:用root权限新建plist文件:sudo nano /Library/LaunchDaemons/limit.maxfiles.plist
第三步:粘贴以下内容(注意替换your_username为你的实际用户名,可通过whoami确认):
<?xml version="1.0" encoding="UTF-8"?><br><br><plist version="1.0"><br><dict><br> <key>Label</key><br> <string>limit.maxfiles</string><br> <key>ProgramArguments</key><br> <array><br> <string>launchctl</string><br> <string>limit</string><br> <string>maxfiles</string><br> <string>524288</string><br> <string>524288</string><br> </array><br> <key>RunAtLoad</key><br> <true></true><br> <key>ServiceIPC</key><br> <false></false><br></dict><br></plist>
第四步:设置正确权限:sudo chmod 644 /Library/LaunchDaemons/limit.maxfiles.plist
第五步:加载配置并重启launchd:sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist && sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
【必须登出再重新登录图形界面,不是新开终端窗口】——这是最关键的一步,否则VS Code、Finder、Chrome等GUI进程仍沿用旧的launchd上下文,maxfiles不会更新。
验证最终生效状态
重新登录后,在任意终端中运行:launchctl limit maxfiles
输出应为:maxfiles 524288 524288
再检查当前shell进程的实际限制:ulimit -n,也应返回524288
最后验证GUI进程是否同步:打开VS Code → 打开集成终端 → 运行ulimit -n,结果必须一致;若仍是旧值,说明未真正登出重进,需强制重启图形会话。











