gunicorn生产就绪需严丝合缝对齐环境：必须在激活虚拟环境中安装，入口模块可被直接导入（如python -c "from app import app"不报错），启动命令必含--bind（推荐unix socket）、--chdir和--user/--group，systemd中execstart须用绝对路径并显式设置pythonpath与workingdirectory。
Gunicorn 能跑起来不等于生产就绪——它必须和 Python 环境、项目路径、启动上下文严丝合缝，否则 gunicorn 进程一启就退出，日志里只有一行 Address already in use 或 No module named 'app'，这根本不是配置问题，是路径或用户权限没对齐。
确认 Python 环境和入口模块能否被正确导入
Gunicorn 不会自动猜你用的是哪个 Python、哪个虚拟环境、哪个文件里定义了 app 实例。它只认绝对路径 + 模块名 + 可调用对象。
- 必须在激活的虚拟环境中安装：
pip install gunicorn（禁用sudo pip或系统级pip） - 入口文件（如
app.py）必须能被 Python 直接导入：运行python -c "from app import app"不报错才算过关 - 如果入口在子目录（如
src/app.py），要么把src加进PYTHONPATH，要么确保--chdir指向项目根目录 - Flask 项目中别留
if __name__ == '__main__': app.run()—— Gunicorn 完全不走这个分支
启动命令里三个必填参数不能省
gunicorn 命令看着简单，但少一个关键参数，服务就只是“能跑”，不是“能用”。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
-
--bind必须指定监听地址：生产环境强烈建议用 Unix socket，例如--bind unix:/tmp/myapp.sock（配合 Nginx），而不是--bind 0.0.0.0:8000（暴露端口风险高） -
--chdir显式指定工作目录：比如--chdir /var/www/myflaskapp，否则 Gunicorn 可能找不到静态文件或requirements.txt -
--user和--group必须设为非 root 用户：例如--user www-data --group www-data，否则 Nginx 无法读取 socket 文件，报Permission denied
systemd 服务文件里最容易写错的三处路径
用 systemd 管理 gunicorn，ExecStart 行里混用相对路径、漏掉虚拟环境激活、忽略环境变量，是服务启动失败的头号原因。
-
ExecStart必须用绝对路径调用虚拟环境里的gunicorn：例如/var/www/myflaskapp/venv/bin/gunicorn，不能写成gunicorn -
WorkingDirectory必须设为项目根目录（如/var/www/myflaskapp），不是venv目录，也不是src目录 - 要显式设置
Environment：至少包括PYTHONPATH=/var/www/myflaskapp和PATH=/var/www/myflaskapp/venv/bin:/usr/bin
验证时别只看进程是否存在
用 systemctl status gunicorn 看到 active (running) 不代表真通了——得查 socket 权限、Nginx 是否能连上、日志里有没有隐性 import 错误。
- 检查 socket 文件权限：
ls -l /tmp/myapp.sock应显示www-data所属，且 Nginx worker 进程能访问 - 用
curl --unix-socket /tmp/myapp.sock http://localhost/直连测试，绕过 Nginx 排查是否是反向代理问题 - 错误日志优先看
journalctl -u gunicorn -n 50 -f，而不是只盯systemctl status的摘要行
最常被忽略的其实是工作目录和 Python 模块导入路径的耦合关系：Gunicorn 启动时的 cwd 决定了 import 的起点，而 --chdir 和 WorkingDirectory 必须一致，否则哪怕代码一字未改，换台服务器就报 ModuleNotFoundError。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
