Google App Engine与Flask应用中URL Handler无法正常工作排查

我帮你梳理了代码和项目结构，你遇到的Not Found错误核心原因是根路径的路由没有被注册到Flask应用实例上，下面详细说问题和修复步骤：

1. 为什么会出现404？ #

你的home.py里定义了/路径的处理函数，但Flask的路由规则是：只有当包含路由的模块被导入时，路由才会绑定到应用实例上。而GAE指定的入口脚本flask_app.py里并没有导入app.handlers.home，所以启动应用时这个路由根本没被加载，服务器自然找不到对应路径的处理逻辑，返回404。

怎么修复？ #

在flask_app.py里添加对home模块的导入，触发路由注册：

import appengine_config
import logging
from app import app_secret_key
from flask import Flask
from flask_wtf.csrf import CSRFProtect
# 加上这行，导入home模块让路由生效
from app.handlers import home

app = Flask(__name__)
app.config.from_object(__name__)
CSRF_PROTECT = CSRFProtect(app)

if appengine_config.GAE_DEV:
    logging.warning('Using a dummy secret key')
    app.secret_key = 'my_dummy_secret_key'
    app.debug = True
else:
    app.secret_key = app_secret_key.secret_key

2. 提前规避模板找不到的问题 #

修复路由后，可能还会碰到模板加载失败的情况——因为你的模板目录是大写的TEMPLATES，而Flask默认会查找小写的templates文件夹。你可以二选一解决：

• 把APP/TEMPLATES重命名为APP/templates（推荐，符合Flask的默认规范）
• 或者初始化Flask时手动指定模板目录：

  app = Flask(__name__, template_folder='TEMPLATES')
  

3. 再确认app.yaml的配置 #

你的app.yaml配置是没问题的，但可以再核对两点：

• script: app.flask_app.app确实指向APP/flask_app.py里的Flask实例app
• 本地调试用的Python版本是2.7（不过Python 2.7已经停止维护了，建议后续升级到GAE的Python 3 runtime）

改完之后重启本地服务器，访问http://127.0.0.1:8080/应该就能正常渲染home.html了。

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