Google App Engine Golang部署后访问返回404页面未找到求助

我之前在GAE部署旧标准环境的Go项目时也碰到过类似的404问题，给你整理几个关键排查步骤：

1. 确认appengine.Main()是否在部署代码中保留 #

这是最容易踩的坑：本地直接运行go run main.go时必须注释appengine.Main()（否则会报错），但部署到GAE时必须恢复这行代码。旧的go1 runtime依赖这个函数来接管请求路由和GAE环境初始化，如果部署时没加回去，服务根本无法正确启动，自然会返回404。

2. 检查路由注册是否正确 #

确保你的代码已经为根路径/注册了对应的handler，而且注册逻辑要在服务启动前执行。旧GAE Go项目通常用init()函数来注册路由（比在main里注册更稳妥），比如：

package main

import (
    "fmt"
    "net/http"
    "google.golang.org/appengine"
)

func rootHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, "Hello from GAE!")
}

// 用init()注册路由，确保在appengine.Main()启动前完成
func init() {
    http.HandleFunc("/", rootHandler)
}

func main() {
    appengine.Main() // 部署时必须保留这行
}

如果没有注册/的handler，访问根路径自然会返回404。

3. 验证app.yaml配置的正确性 #

旧标准环境的app.yaml需要严格符合以下要求：

• 必须保留runtime: go和api_version: go1
• handlers规则中script: _go_app是固定值，不能修改
• url规则要确保覆盖到根路径，比如url: /.*是正确的（匹配所有路径），如果只写url: /只会匹配根路径本身，不会匹配子路径，但你说改了还是404，那大概率不是这个问题。另外注意handlers的顺序是从具体到通用，如果有更靠前的规则覆盖了根路径，也会出问题。

4. 检查部署的代码是否正确 #

有时候我们本地改了代码，但部署时指定了错误的目录，或者缓存的旧代码被部署了：

• 用gcloud app versions list查看当前部署的版本
• 用gcloud app versions describe [你的版本ID]确认代码是否正确上传
• 确保main.go在项目根目录，旧GAE runtime不支持复杂的子目录结构（除非用includes配置，但简单项目没必要）

5. 查看完整的线上日志 #

只看"GET /" 404不够，要查看更详细的日志来定位问题：

gcloud app logs read --version [你的版本ID]

如果日志里有编译错误、依赖缺失或者appengine.Main()执行失败的信息，那就能直接找到原因。比如本地有未上传的依赖，部署时编译失败，服务无法启动，就会返回404。

6. 用本地开发服务器模拟线上环境 #

不要直接注释appengine.Main()跑本地，而是用GAE官方的本地开发工具来模拟线上环境：

dev_appserver.py app.yaml

如果本地用这个工具跑也返回404，那说明代码或配置有问题，直接在本地排查更高效。

额外建议：考虑迁移到新的Go runtime #

旧的go1 runtime已经被GAE弃用，不再更新维护。新的Go runtime（比如runtime: go1.21）支持标准的net/http写法，不需要appengine.Main()，本地和线上代码完全一致，部署更简单，还能使用最新的Go版本。如果项目复杂度不高，建议尽快迁移。

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