Waitress强制使用5000端口问题求助（Flask亦存在同类异常）

这种强制固定5000端口的情况，大概率是你的启动方式或者环境配置覆盖了代码里的设置，我来帮你一步步排查和解决：

1. 检查你的启动方式 #

你是不是用flask run命令启动应用的？如果是这样，那你代码里的app.run()或者waitress.serve()根本不会被执行！Flask CLI命令会自己加载应用，默认使用5000端口，完全忽略你代码里的端口配置。

解决方法：

• 直接运行你的脚本文件：比如在命令行执行python app.py，这样if __name__ == "__main__"块里的代码才会生效；
• 如果你坚持用flask run，可以通过环境变量指定端口：

  # Windows命令行设置临时环境变量
  set FLASK_RUN_PORT=8000
  flask run --host=0.0.0.0
  

  或者在项目根目录创建.flaskenv文件，永久配置：

  FLASK_RUN_PORT=8000
  FLASK_RUN_HOST=0.0.0.0
  

2. 检查是否存在覆盖端口的环境变量 #

Flask会优先读取FLASK_PORT或者FLASK_RUN_PORT环境变量的值，哪怕你代码里明确指定了port参数也没用。

你可以在命令行输入以下命令查看是否有相关配置：

echo %FLASK_RUN_PORT%
echo %FLASK_PORT%

如果输出了数值（比如5000），要么删除这个环境变量，要么修改成你想要的端口值。

3. 排查IDE运行配置的影响 #

如果你用PyCharm、VS Code等IDE运行应用，检查一下运行配置里是不是手动指定了端口参数：

• 比如PyCharm的「运行/调试配置」中，是否在「参数」栏添加了--port 5000；
• 或者在配置的「环境变量」里设置了FLASK_RUN_PORT=5000这类条目；
  这些配置会直接覆盖你代码里的设置。

4. 确认if __name__ == "__main__"代码块是否生效 #

有时候如果你的脚本被其他模块导入，这个代码块里的内容不会执行。你可以加个测试打印来验证：

if __name__ == "__main__":
    print("正在通过Waitress启动应用...")
    from waitress import serve
    serve(app, host='0.0.0.0', port=8000)

运行脚本时如果没看到这句打印，说明这段代码根本没被执行，那应用肯定还是用了默认的5000端口启动。

5. 确认Waitress的导入是否正确 #

确保你在代码顶部正确导入了Waitress的serve方法：

from waitress import serve

如果导入错误，运行时会抛出异常，但如果是不小心导入了其他同名模块，也可能导致异常行为，不过这种情况比较少见。

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