FastAPI应用作为systemd守护进程启动失败，如何排查？

以下是针对问题的具体排查和修复步骤：

1. 解决启动过快触发的systemd保护机制 #

systemd默认会阻止短时间内重复重启的服务，添加RestartSec参数设置重启间隔，避免被判定为异常循环。修改/etc/systemd/system/fastapi.service的[Service]段：

[Service]
User=myuser
Group=myuser
WorkingDirectory=/home/myuser/webapp
ExecStart=/usr/local/bin/uvicorn main:app --host 127.0.0.1 --port 8000
Restart=always
RestartSec=5  # 添加这一行，设置5秒重启间隔

2. 检查Python虚拟环境路径（若使用） #

手动运行时你可能激活了虚拟环境，但systemd不会自动加载虚拟环境的依赖。如果你的FastAPI依赖安装在虚拟环境中，需替换ExecStart中的uvicorn路径为虚拟环境内的可执行文件。例如虚拟环境位于/home/myuser/webapp/venv：

ExecStart=/home/myuser/webapp/venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000

3. 开启详细日志定位具体错误 #

修改ExecStart添加调试日志参数，获取uvicorn启动时的具体报错信息：

ExecStart=/usr/local/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --log-level debug

更新配置后重启服务并查看日志：

sudo systemctl daemon-reload
sudo systemctl restart fastapi.service
sudo journalctl -xeu fastapi.service

日志会显示启动失败的具体原因（如依赖缺失、文件权限不足等）。

4. 验证工作目录权限 #

确保myuser对应用目录拥有完整权限：

sudo chown -R myuser:myuser /home/myuser/webapp
sudo chmod -R 755 /home/myuser/webapp

5. 重新加载配置并启动服务 #

每次修改service文件后，必须重新加载systemd配置：

sudo systemctl daemon-reload
sudo systemctl enable fastapi.service
sudo systemctl start fastapi.service

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