Flask请求根路径/返回404、首页跳转失效问题该如何解决？

1. 确认路由是否正确注册到Flask应用实例 #

• 检查路由@app.route装饰器使用的app实例，是否和最终调用run()启动的实例为同一个：多文件拆分代码时很容易出现路由注册到了新建的空app实例，没有绑定到实际运行的实例的问题。
• 可以在应用启动逻辑前加一行代码打印所有已注册路由，验证根路由是否存在：

print(app.url_map)

如果输出结果中没有/对应的路由规则，说明根路由根本没有注册到运行的服务实例中。

• 如果使用了Blueprint蓝图管理路由，检查蓝图挂载到app时是否设置了多余的url_prefix：比如给蓝图设置了url_prefix='/api'的话，蓝图下定义的/路由实际访问路径是/api/，访问根路径/自然会返回404。

2. 排查前置拦截逻辑是否截断了请求 #

• 检查是否定义了@app.before_request全局请求钩子，有没有在钩子逻辑中对根路径请求做了拦截，直接返回404或者跳转，导致请求根本没有走到路由匹配步骤。
• 检查静态文件配置是否和路由冲突：如果设置了static_url_path=''，或者static_folder指向根目录，Flask会优先匹配静态文件路径，找不到对应静态资源就直接返回404，不会走到自定义路由逻辑。
• 检查是否是反向代理配置错误：比如Nginx没有把请求正确转发到Flask服务端口，而是打到了其他服务返回404，可以直接在服务本地执行curl命令验证：

curl http://127.0.0.1:你的Flask运行端口/

如果本地curl能正常返回结果，就说明问题出在反向代理配置上。

3. 确认应用启动配置无误 #

• 检查Flask启动入口是否正确：如果用环境变量FLASK_APP指定启动文件，确认有没有指定错文件，导致启动了另一个没有定义根路由的应用。
• 确认修改代码后已经重启了服务：如果没有开启DEBUG模式，修改的路由代码不会自动热重载，运行的还是旧版本代码。
• 检查是否有重名的视图函数覆盖了根路由配置，重复注册同路径路由时Flask会以最后注册的为准。

常见解决方法 #

• 路由注册到错误实例的场景：统一使用同一个app实例，或者用蓝图统一管理路由后正确挂载到app。
• 前置钩子拦截的场景：调整钩子逻辑，放行根路径、登录页等不需要登录校验的路径。
• 静态路径冲突的场景：把static_url_path改回默认的/static，避免和业务路由冲突。
• 反向代理配置错误的场景：修正Nginx等代理的转发规则，确保请求正确转发到Flask服务的端口。

内容的提问来源于stack exchange，提问作者Kang Soon-cheol