FastAPI通过Supervisor启动Gunicorn失败问题求助

问题根源 #

直接运行gunicorn命令时，当前shell的环境变量（比如数据库用户名、密码）会被程序正常读取；但Supervisor启动进程时，默认不会继承用户shell的完整环境变量，导致你的FastAPI程序无法获取数据库配置，出现Access denied for user 'None'@'localhost'错误——这里的None说明程序读取数据库用户名的变量为空。

解决方案 #

1. 在Supervisor配置中显式设置环境变量 #

修改你的Supervisor配置文件，添加environment字段，把数据库连接所需的环境变量明确写进去：

[program:fastapi]
directory=/home/fauser/fastapifolder/fastapi
command=/home/fauser/fastapifolder/.virtual/bin/gunicorn -c gunicorn_config.py main:app
autostart=true
autorestart=true
stdout_logfile=/home/fauser/fastapifolder/fastapi/logs/gunicorn-error.log
redirect_stderr=true
# 替换为你的实际数据库配置
environment=DB_USER='your_db_username',DB_PASSWORD='your_db_password',DB_NAME='your_db_name'

修改后重启Supervisor生效：

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl restart fastapi

2. 确保配置文件路径正确 #

如果你的数据库配置是从本地文件（比如.env）读取的，检查程序中是否使用了相对路径。Supervisor的directory已指定为/home/fauser/fastapifolder/fastapi，要么确保配置文件在这个目录下，要么在代码中改用绝对路径读取：

from dotenv import load_dotenv
import os

# 用绝对路径加载配置文件
load_dotenv(os.path.join('/home/fauser/fastapifolder/fastapi', '.env'))

3. 模拟Supervisor环境验证问题 #

可以先模拟Supervisor的运行环境测试命令，确认是否是环境变量问题：

# 切换到fauser用户，不加载shell配置（模拟Supervisor的环境）
su - fauser --login-shell=false -c "/home/fauser/fastapifolder/.virtual/bin/gunicorn -c gunicorn_config.py main:app"

如果该命令同样报错，说明确实是环境变量缺失，按方案1补充即可。

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