通过Homebrew启动/重启Nginx时立即崩溃且无日志

一、手动启动Nginx查看实时报错 #

• 先清理残留进程：pkill -9 nginx
• 以非守护进程模式启动，强制在终端输出错误：/opt/homebrew/bin/nginx -c /opt/homebrew/etc/nginx/nginx.conf -g 'daemon off;'
  这种方式不会后台运行，启动失败的所有错误都会直接打印在终端，是快速定位问题的核心手段。

二、检查配置文件语法合法性 #

• 执行配置校验命令：/opt/homebrew/bin/nginx -t
  任何配置语法错误、路径不存在、指令误用等问题，都会被这个命令直接指出，包括错误所在的行号。

三、排查权限问题 #

• 检查关键目录权限：
  • 日志目录：ls -ld /opt/homebrew/var/log/nginx，确保Nginx运行用户（通常是当前用户或_www）有读写权限
  • 配置目录：ls -ld /opt/homebrew/etc/nginx，确保有读取权限
  • PID临时目录：ls -ld /opt/homebrew/var/run，Nginx需要在此写入pid文件，必须有写入权限
• 尝试用sudo启动测试：sudo /opt/homebrew/bin/nginx，如果能正常启动，说明是普通用户权限不足，后续调整对应目录权限即可。

四、检查端口占用情况 #

• Nginx默认监听80、443端口，检查这些端口是否被其他程序占用：
  • 80端口：lsof -i :80 或 sudo lsof -i :80
  • 443端口：lsof -i :443 或 sudo lsof -i :443
    若有占用，要么终止对应进程，要么修改Nginx配置里的listen指令更换端口。

五、检查Homebrew服务配置 #

• Homebrew的Nginx服务配置文件在~/Library/LaunchAgents/homebrew.mxcl.nginx.plist（用户级）或/Library/LaunchDaemons/homebrew.mxcl.nginx.plist（系统级）
• 打开文件检查：
  • ProgramArguments中的Nginx路径是否为/opt/homebrew/bin/nginx
  • StandardErrorPath和StandardOutPath是否配置了日志路径，部分情况下Homebrew服务会把日志写到这里而非Nginx默认目录
• 手动加载配置测试：launchctl load ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist，观察终端输出的错误信息。

六、确认架构兼容性 #

• M1 Max为ARM架构，检查Nginx版本是否适配：
  • 执行file /opt/homebrew/bin/nginx，输出需包含arm64字样；若显示x86_64，说明是通过Rosetta安装的，存在兼容性风险，需用原生ARM终端重新执行brew install nginx。

内容的提问来源于stack exchange，提问作者jzw