Gunicorn启动Python Web服务时是否会执行if __name__ == '__main__'代码块
核心结论
你写在manage.py里的if __name__ == '__main__'代码块,在Gunicorn驱动的服务运行流程里完全不会被触发执行。
具体原因说明
- Python解释器的内置运行规则:只有当某个
.py文件被当做主脚本直接启动(比如执行python manage.py命令)时,这个文件内部的内置变量__name__才会被赋值为'__main__',进而触发这个if判断块的逻辑。 - Gunicorn启动服务时对
manage.py的处理,根本不是“把它当主脚本直接运行”,而是将其作为普通Python模块导入加载:- Gunicorn解析你写的
manage:app启动参数,定位到同路径下的manage.py文件,走标准的模块导入流程 - 导入过程中会按顺序执行文件里所有顶层可执行代码——你写的
app = create_app()这行一定会正常执行,Gunicorn正是靠这行生成的app实例,作为后续对接WSGI请求的入口对象 - 整个导入流程里,
manage.py的__name__值是文件对应的模块名'manage',和if判断里的'__main__'完全不匹配,块里的flask_thread(func = run)、client.run(os.getenv('TOKEN'))两行代码根本不会进入执行分支。
- Gunicorn解析你写的
补充提示
- 哪怕你配置了多worker、多线程的启动参数,每个worker进程初始化时都是重复上面的模块导入流程,全程不会触发主脚本判断逻辑。
- 原启动命令里的
--workers = 3 --threads = 3因为等号和参数值之间带了空格,Gunicorn解析参数时会报错,实际编写命令时要去掉等号两侧的空格,写成--workers=3 --threads=3才能正常启动。 - 只有当你在Gunicorn配置里写了非常规的主脚本调用逻辑(比如手动通过子进程拉起
python manage.py进程、或者用动态代码执行的方式把manage.py当做主脚本运行),才可能执行到这段if块的内容,标准的Gunicorn生产启动流程里完全不会出现这种情况。
内容的提问来源于stack exchange,提问作者perymerdeka
相关产品推荐
相关产品推荐

