Flask应用部署上线持续报错 访问托管链接显示not found

跨多个托管平台部署均返回not found、运行日志无任何报错，本质是部署时启动的Flask实例没有注册任何你写的业务路由，平台默认拉起了一个空的Flask应用，所有请求自然返回404，和业务代码逻辑无关，所以不会打印异常日志。

具体触发原因有三个：

• 启动文件、应用实例名不符合PaaS平台的默认识别规则：市面上绝大多数支持Flask的托管平台，默认会读取项目根目录下名为app.py的文件，自动导入其中名为app的Flask实例对外提供服务。你的项目文件命名、Flask实例命名和这个默认规则完全不匹配，平台根本没加载到你写了路由的业务代码。
• 路由绑定对象错误：你写的所有接口路由，都装饰在自定义命名的Flask实例上，和平台实际启动的实例是完全独立的两个对象，等于你写的所有页面路径根本没注册到对外服务的应用上。
• 缺失平台部署配置文件：项目根目录没有符合规范的启动配置文件，平台无法读取你自定义的启动命令，只能用默认规则启动空应用。

按以下步骤调整后重新部署即可恢复访问：

1. 调整项目结构：把写了Flask业务逻辑的核心文件重命名为根目录下的app.py，文件内Flask实例初始化统一写为app = Flask(__name__)，所有路由装饰器@app.route()都绑定到这个app实例上，不要额外定义其他Flask实例承接路由。
2. 移除本地调试的硬编码启动配置：删掉代码里写死的app.run(host="127.0.0.1", port=xxxx)配置，托管平台会自动分配监听端口和公网访问地址，硬写本地回环地址反而会阻断公网请求。
3. 补全必要的部署配置文件：
   • 根目录的requirements.txt里明确列出所有依赖，至少要包含Flask和项目用到的其他第三方库
   • 针对需要显式声明启动命令的平台，根目录新建Procfile，写入内容web: gunicorn app:app即可
4. 部署前本地验证：在项目根目录执行gunicorn app:app，本地访问对应端口测试所有页面、接口都能正常响应，再推送代码到仓库触发平台重新部署。

生产环境部署时记得关闭Flask的debug模式，避免触发远程代码执行安全风险。

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