Google App Engine 经典环境（Go 1 运行时）不支持 cgo，而 gokogiri 等依赖 C 库的 Go 包会因 nobuild_files 规则被完全跳过编译，导致“required but all its files were excluded”错误。根本解决路径是迁移至支持 cgo 的托管虚拟机（Managed VMs）环境。
google app engine 经典环境（go 1 运行时）不支持 cgo，而 `gokogiri` 等依赖 c 库的 go 包会因 `nobuild_files` 规则被完全跳过编译，导致“required but all its files were excluded”错误。根本解决路径是迁移至支持 cgo 的托管虚拟机（managed vms）环境。
在 Google App Engine 的经典运行时（runtime: go + api_version: go1）中，构建系统默认启用 -nobuild_files ^^$ 参数，该参数会自动排除所有含 cgo 指令（如 import "C"）或依赖 C 标准库/本地库的 .go 文件。你所引用的 github.com/moovweb/gokogiri 正是一个典型的 cgo 包——它基于 libxml2 和 libxslt 封装，内部大量使用 #include
当 goapp serve 执行构建时，App Engine SDK 的 go-app-builder 工具扫描所有依赖源码（包括 Godeps/_workspace/ 下的内容），一旦发现 gokogiri/html/ 目录下任一文件包含 import "C"（例如 document.go 或 fragment.go），整目录即被判定为“不可构建”，最终抛出如下关键错误：
go-app-builder: Failed parsing input: package github.com/moovweb/gokogiri/html required, but all its files were excluded by nobuild_files
⚠️ 注意：这不是 godep save 或路径配置问题，也不是 app.yaml handler 设置错误——而是平台级限制。经典运行时沙箱禁止任何本地系统调用与动态链接，cgo 天然违反该安全模型。
✅ 正确解决方案：启用 Managed VMs（现称 App Engine flexible environment）
只需两步完成迁移：
-
更新 app.yaml，启用 VM 模式并指定 Go 运行时：
# app.yaml runtime: go env: flex # 替换 classic 的 'api_version'，明确使用 flexible 环境 automatic_scaling: min_num_instances: 1
移除 api_version 和 handlers 块（flex 环境由 main 函数自动路由，无需显式 script 配置）
同时确保项目根目录下存在标准 main.go（或 app.go 中含 func main()），且监听 PORT 环境变量：
// app.go
package main
import (
"log"
"net/http"
"os"
"github.com/go-martini/martini"
"github.com/martini-contrib/render"
"github.com/moovweb/gokogiri/xml"
)
func main() {
m := martini.Classic()
m.Use(render.Renderer())
m.Get("/", func(r render.Render) {
doc, _ := xml.Parse(`<root><child>hello</child></root>`)
r.HTML(200, "index", map[string]string{"XML": doc.Root().Name()})
})
port := os.Getenv("PORT")
if port == "" {
port = "8080"
}
log.Printf("Listening on port %s", port)
http.ListenAndServe(":"+port, m)
}? 补充说明：
- Managed VMs（flex）底层为 Docker 容器，完整支持 go build、cgo、任意系统依赖（需通过 Dockerfile 或 app.yaml 的 runtime_config 安装）；
- 无需 godep：推荐改用 Go Modules（go mod init && go mod tidy），App Engine flexible 会自动识别并 vendor；
- 构建命令更新为：gcloud app deploy（而非 goapp serve）；
- 本地开发可直接 go run app.go 测试，无需 SDK 模拟器。
总结：当你在 App Engine 经典环境中遇到 “required but all its files were excluded by nobuild_files”，首要判断是否引入了 cgo 包（grep -r "import.*C" $GOPATH/src/ 快速筛查）。若确认依赖 cgo，则必须升级至 flexible 环境——这是 Google 官方明确支持的唯一合规路径，而非尝试禁用 nobuild_files（该参数不可覆盖）或剥离 cgo 功能（将破坏包核心逻辑）。
