Supervisord 静默失败主因是配置错误（如 directory 不存在、user 权限不足、日志路径未创建），需重点检查 unix_http_server、childlogdir 和 include 三处主配置，并确保 program 段满足绝对路径、目录存在且可访问、日志父目录手动创建、user 权限合法四大硬性条件。

Supervisord 能自动拉起崩溃进程，但配置错一个参数（比如 directory 不存在、user 没权限、日志路径没创建），它就直接静默失败——不报错、不启动、也不写日志。

supervisord.conf 主配置里最关键的三处修改

主配置文件默认在 /etc/supervisor/supervisord.conf，但多数发行版（如 Ubuntu）实际加载的是 /etc/supervisor/supervisord.conf 中的 [include] 指向的子配置。你真正要动的其实是这三块：

• [unix_http_server]：必须保留，否则 supervisorctl 连不上。确认 file= 路径存在且权限宽松（如 chmod=0700），chown 用户得和运行 supervisord 的用户一致
• [supervisord] 下的 childlogdir：建议显式设为 /var/log/supervisor/ 并提前 mkdir -p /var/log/supervisor，否则子进程日志会写失败
• [include]：取消注释并改成你放项目配置的目录，例如 files = /etc/supervisor/conf.d/*.conf ——注意路径必须存在，且文件扩展名要和你实际写的匹配（.conf 或 .ini）

program 配置里最容易被忽略的四个硬性条件

每个被管理的程序都得写在单独的 [program:name] 段里。以下四点任一不满足，supervisorctl start name 就会返回 ERROR (no such process) 或直接无响应：

• command 必须是**绝对路径**的可执行文件或脚本，不能用 ~ 或环境变量（如 $HOME）；Java 启动要写全 /usr/bin/java，Python 要写 /usr/bin/python3
• directory 必须真实存在，且 user 对该目录有读+执行权限（cd 进去要成功）；如果用 root 启动但目录属主是普通用户，会卡住
• stdout_logfile 和 stderr_logfile 的**父目录必须手动创建**，supervisord 不会帮你建目录，只建文件；路径里不能含未定义的变量
• user 字段如果指定，该用户必须能执行 command 中的二进制，并有权限访问 directory 和日志路径；若留空，默认用启动 supervisord 的用户（常是 root）

autorestart=true 不生效？先查这三个信号行为

autorestart=true 只对「进程退出」生效，不是所有“挂了”都算退出。常见失效场景：

Linux Security Scanner

Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...

下载

• 进程变成僵尸（zombie）但父进程没回收：supervisord 看不到退出事件，不会重启；需确保你的程序不产生长期僵尸进程
• 用了 stopasgroup=true 但子进程没响应 STOP 信号：supervisord 发送停止信号后等超时，直接 kill -9，后续 restart 逻辑可能被跳过
• startsecs 设太短（如 1 秒），而程序实际启动慢（Spring Boot 常要 5–8 秒）：supervisord 认为启动失败，反复重试直到 startretries 耗尽，然后停住不再试
• 进程自己 daemon 化（加 & 或调用 daemon()）：supervisord 失去控制权，无法捕获退出；必须禁用程序自身的 daemon 模式

supervisorctl reload 后程序没更新？检查配置加载顺序

执行 supervisorctl reread + supervisorctl update 是标准流程，但容易漏掉：

• reread 只扫描 [include] 指定路径下**新增或修改过的配置文件名**，如果只是改了内容但文件名没变，它可能不识别；保险做法是 touch 一下配置文件再 reread
• update 仅对 reread 已识别出的程序生效；如果某 program 段语法错误（比如少了个 =），reread 会跳过它，update 也看不到它
• 配置文件里用分号 ; 注释时，; **前后必须有空格**，否则整行可能被当作文本解析失败（尤其在 environment= 行后紧挨着写注释）
• 改完配置别忘了 supervisorctl status 看输出，状态为 STARTING 或 BACKOFF 说明还在尝试，FATAL 才是真失败，得查 supervisord.log

最常被绕开的点：supervisord 自身日志（/var/log/supervisor/supervisord.log）里藏了所有加载失败的真实原因，比如 “can't find command”、“permission denied on directory”、“can't create log file”，但它默认级别是 info，得把 loglevel 改成 debug 才能看到完整上下文。