Mac上“Resource temporarily unavailable”错误源于用户级最大进程数(maxproc)耗尽,需通过ulimit临时调整或配置LaunchDaemon永久修改限制。

Mac上运行Java多线程应用、Docker Desktop或大量Node.js子进程时,频繁报错“Resource temporarily unavailable”,说明当前用户级最大进程数(maxproc)已耗尽,必须修改系统限制才能继续创建新进程。
确认当前maxproc限制值
打开终端,执行以下命令查看当前软硬限制:
ulimit -a | grep "max user processes"
输出形如 max user processes (-u) 709,其中709即当前软限制值;若需查看硬限制,单独运行 ulimit -Hu。注意:该值远低于实际负载需求,且默认不随系统升级自动提升。
临时提高当前会话的maxproc限制
这一步仅对当前终端及其派生进程生效,适合快速验证是否为该限制导致问题:
执行 ulimit -u 2048 即可将软限制设为2048;若提示“operation not permitted”,说明硬限制过低,需先提硬限:ulimit -Hu 2048(需当前shell具备相应权限)。
⚠️ 此设置在关闭终端或退出SSH会话后立即失效,不可用于生产环境长期运行的服务。
永久修改用户级maxproc限制(推荐方法)
macOS不读取/etc/security/limits.conf,必须通过LaunchDaemon机制实现全局持久化。操作路径如下:
第一步:用管理员权限创建配置文件sudo nano /Library/LaunchDaemons/limit.maxproc.plist
第二步:粘贴以下完整XML内容(注意标签闭合与缩进,任何格式错误将导致加载失败):
<?xml version="1.0" encoding="UTF-8"?><br><br><plist version="1.0"><br><dict><br><key>Label</key><br><string>limit.maxproc</string><br><key>ProgramArguments</key><br><array><br><string>launchctl</string><br><string>limit</string><br><string>maxproc</string><br><string>2048</string><br><string>2048</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.maxproc.plistsudo chown root:wheel /Library/LaunchDaemons/limit.maxproc.plist
第四步:加载配置并重启系统使设置生效:sudo launchctl load -w /Library/LaunchDaemons/limit.maxproc.plist
【必须重启Mac,仅reload无法让所有用户会话识别新限制】











