启动gunicorn.service报200/CHDIR错误如何排查修复？

错误本质 #

status=200/CHDIR是systemd层面抛出的错误，核心原因是服务启动进程时，无法成功切换到WorkingDirectory配置项指定的工作目录，导致gunicorn主进程直接退出。

逐项排查点 #

• 校验工作目录真实存在：执行ls /var/www/botproject/确认路径无拼写错误，常见错误是目录名大小写不对、多打/少打字符、目录实际存放在其他路径。
• 逐层校验目录权限：执行namei -l /var/www/botproject/，从/根目录开始逐层检查每一级路径的执行权限，配置的运行用户是root的场景下正常不会有权限问题，但如果上级目录被误设为000权限、目录挂载在异常断开的网络存储/加密分区上，也会导致切换失败。
• 检查路径是否带隐藏特殊字符：复制路径时如果混入了空格、换行、全角斜杠这类不可见/非法字符，肉眼无法识别但systemd会判定路径不存在，可以手动重新输入一遍WorkingDirectory的路径排除该问题。
• 补全gunicorn的绝对路径：当前配置里ExecStart写的是相对路径gunicorn，先执行which gunicorn拿到可执行文件的完整绝对路径（全局安装通常是/usr/local/bin/gunicorn，用虚拟环境的话要写虚拟环境bin目录下的gunicorn路径），避免systemd从默认PATH里找不到可执行文件抛出连带错误。
• 排除SELinux拦截：如果服务器开了SELinux，/var/www目录的安全上下文配置错误也会拦截目录切换操作，可临时执行setenforce 0关闭SELinux测试，若关闭后服务正常启动，重新给项目目录打正确的SELinux上下文即可。

修正后的参考配置 #

[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target

[Service]
User=root
Group=root
# 注意不要在路径末尾加多余斜杠，部分旧版本systemd解析带尾斜杠的路径会异常
WorkingDirectory=/var/www/botproject
# 替换成你实际which gunicorn查到的绝对路径
ExecStart=/usr/local/bin/gunicorn --workers 5 --bind unix:/run/gunicorn.sock botproject.wsgi:application

[Install]
WantedBy=multi-user.target

配置生效步骤 #

1. 修改完service文件后，执行systemctl daemon-reload重新加载systemd配置
2. 执行systemctl start gunicorn启动服务
3. 执行systemctl status gunicorn校验服务运行状态

排错小技巧：如果按上述步骤排查后仍启动失败，直接手动切换到/var/www/botproject目录，执行和ExecStart完全一致的命令，手动执行能正常启动的话，问题一定出在service文件的路径配置、权限配置上。

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