Nginx 的 pid 文件路径必须在 main context 中用绝对路径显式配置，如 pid /run/nginx.pid;，否则静默无效；需确保目录存在、权限正确，并与 systemd 的 PIDFile= 完全一致，多实例须隔离路径。
在 Nginx 中，pid 文件路径必须通过全局块（main context）中的 pid 指令显式配置，它不自动生成，也不接受相对路径。这个文件是读取主进程 ID 的唯一可信来源，直接影响 reload、stop、监控和自动化脚本的可靠性。
必须放在 nginx.conf 最外层
pid 指令只能出现在配置文件最顶层，不能嵌套在 http、events 或 server 块中——否则会被静默忽略，不报错但无效。
- ✅ 正确示例：
pid /run/nginx.pid;（写在user、worker_processes同级位置） - ❌ 错误示例：
http { pid /tmp/nginx.pid; }—— 配置能加载，但主进程不会写入该路径
路径要绝对、目录要存在、权限要合理
路径必须是绝对路径，且所在目录需提前创建，并确保 Nginx 主进程（通常是 root）有写入权限。
- 推荐路径：
/run/nginx.pid（systemd 环境首选），需在对应 unit 文件中声明RuntimeDirectory=nginx - 兼容路径：
/var/run/nginx.pid（符合 FHS），但该目录常为 tmpfs，重启即清空，需在启动前用脚本创建并赋权 - 避免路径：
/tmp/nginx.pid—— 可能被系统定时清理，无服务归属标识，易误删
与 systemd 单元保持完全一致
若使用 systemctl 管理，unit 文件中的 PIDFile= 必须和 nginx.conf 中的 pid 指令值一字不差，否则 systemctl status nginx 会显示 “main process unknown”。
- 检查方式：
systemctl show --property=PIDFile nginx对比grep "^pid" /etc/nginx/nginx.conf - 修改后务必执行：
nginx -t && systemctl reload nginx或完整重启
多实例部署必须隔离 PID 路径
同一台机器运行多个 Nginx 实例时，共用 PID 文件会导致信号发错、reload 失效、状态混乱等问题。
- API 实例：配置中写
pid /run/nginx-api.pid;，unit 文件设PIDFile=/run/nginx-api.pid - Web 实例：配置中写
pid /run/nginx-web.pid;，unit 文件设PIDFile=/run/nginx-web.pid - 启动命令也要区分：
nginx -c /etc/nginx/api.conf和nginx -c /etc/nginx/web.conf
