Google Cloud App Engine 如何通过 app.yaml 配置重定向 .html 后缀请求

首先明确核心结论：Google App Engine 标准环境的 app.yaml 内置路由能力，本身不支持基于路径规则的批量URL重定向替换，你查阅文档没找到对应配置是正常的——该文件的handlers规则仅支持静态文件目录映射、固定路径的静态资源返回、将匹配路径的请求转发给后端应用进程三类能力，没有提供“捕获路径正则片段、拼接生成新跳转地址”的配置参数，根本没法直接在yaml配置里写死重定向逻辑。

可行的实现路径 #

方案1：在Flask应用层加全局请求钩子（推荐，零额外配置改动） #

你本身使用Flask作为后端，完全不需要修改任何GAE配置，直接在应用里加全局请求前置处理逻辑，就能覆盖所有带.html后缀的历史反向链接请求：

• 实现逻辑：在请求进入具体业务路由之前，统一判断当前请求路径，如果以.html结尾，就去掉对应后缀，返回301永久重定向到无后缀的对应路径，同时保留原有查询参数，避免链接携带的跟踪参数、分页参数丢失。
• 参考代码片段：

from flask import request, redirect

@app.before_request
def handle_html_suffix_redirect():
    # 匹配所有以.html结尾的请求路径
    if request.path.endswith('.html'):
        # 去掉末尾的.html后缀
        cleaned_path = request.path[:-5]
        # 拼接原请求携带的查询参数
        if request.query_string:
            cleaned_path = f"{cleaned_path}?{request.query_string.decode()}"
        # 返回301永久重定向，让搜索引擎将旧链接的权重传递到新无后缀路径
        return redirect(cleaned_path, code=301)

这个方案可以覆盖所有层级的路径结构，比如/blog.html、/category/tech/article.html这类嵌套路径，都能自动对应跳转到去掉后缀的目标路径，完全适配你现有的无后缀路由规则，也不需要额外引入其他云服务组件。

方案2：通过app.yaml做请求分流 #

如果你不想依赖Flask的全局匹配，也可以在app.yaml里加一条路由规则，把所有匹配.html后缀的请求直接转发给应用处理，本质上这只是做请求分流，并不会自动完成跳转，最终的路径替换逻辑依然要在Flask层实现，和方案1的效果没有区别：

handlers:
  # 匹配所有带.html后缀的请求，直接转发给Flask应用
- url: /(.*\.(html))$
  script: auto
  # 其余原有静态资源、应用路由规则保持原有配置即可

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