Google App Engine Go项目自定义404错误页面配置求助

嗨，我明白你现在的困扰——折腾了app.yaml的error_handlers配置，自定义404页面就是不出来，还是显示GAE默认的错误页。别着急，咱们一步步来排查和解决：

问题出在哪？ #

看了你提供的两个app.yaml版本，核心问题有两个：

1. 错误页面的路径配置错误：你更新后的版本里写了file: /page-not-found.html，但你的静态文件都放在www目录下，这个绝对路径找不到你的自定义页面；
2. 缺少明确的错误码绑定：没有指定error_code: 404，GAE可能无法精准触发对应的自定义页面规则。

另外，你的静态文件handler/(.*)会匹配所有URL，但当请求的文件不存在时，GAE会返回404状态码，这时候需要正确的error handler配置来替换默认页面。

正确的app.yaml配置 #

直接用下面的配置替换你的版本，注意关键细节：

runtime: go
api_version: go1

handlers:
- url: /
  static_files: www/index.html
  upload: www/index.html
- url: /(.*)
  static_files: www/\1
  upload: www/(.*)
  # 可选：强制HTTPS访问，根据你的需求调整
  secure: always

error_handlers:
- error_code: 404
  # 路径是相对于应用根目录的，和你的静态文件存放位置一致
  file: www/page-not-found.html

关键配置说明 #

• 明确绑定404错误码：error_code: 404告诉GAE，只有当返回404状态码时，才使用这个自定义页面；
• 正确的文件路径：www/page-not-found.html是相对路径，和你上传静态文件的目录结构对应，确保GAE能找到这个文件；
• 静态文件覆盖规则：你的/(.*)handler已经覆盖了所有静态文件请求，当文件不存在时会触发404，这时候error handler就会生效。

后续验证步骤 #

1. 确认www/page-not-found.html确实存在于你的项目根目录的www文件夹中；
2. 使用gcloud app deploy重新部署你的应用，确保新配置生效；
3. 测试时可以用隐身窗口打开错误URL，避免浏览器缓存导致看不到更新后的页面。

这样配置后，再输入错误URL或者访问不存在的页面，应该就能看到你自定义的404页面了！

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