beego项目上线部署需满足三要素：平台可识别（严格遵循gopath/src或go.mod规范）、端口显式绑定（如0.0.0.0:5000而非默认127.0.0.1:8080）、依赖完全固化（go.mod+go.sum或godeps提交至git），并禁用dev模式、重定向日志、修正v2导入路径。
Beego 项目部署的核心不是“能不能跑”，而是“能不能被平台识别、端口是否开放、依赖是否可还原”。默认用 bee run 启动只适合本地开发，上线必须走标准 Go 构建 + 显式端口绑定 + 依赖固化流程。
确保 GOPATH 和项目结构符合 Go workspace 规范
平台（如云服务或 CI/CD 环境）依赖标准 Go 工作区结构识别项目。如果项目不在 $GOPATH/src/xxx 下，go build 可能找不到导入路径，godep save 会报 Package not found。
- 项目根目录必须是
$GOPATH/src/your-app-name，不能是随意路径下的子目录 -
main.go必须在项目根目录，且包含package main和合法的import块 - 所有 Beego 相关 import（如
github.com/beego/beego/v2）需能被go list解析到，否则godep save ./失败 - 若用 Go Modules（推荐），则项目根目录必须有
go.mod，且GO111MODULE=on；此时不用GOPATH，但需确认go build不报cannot find module
显式指定监听地址和端口，别依赖 app.conf 默认值
Beego 默认读 conf/app.conf，但很多部署环境不加载该文件，或只认硬编码配置。更稳妥的做法是在 main.go 中直接传参控制监听行为。
- 删掉或注释掉
beego.Run()，改用beego.BeeApp.Run()并手动设置参数 - 在
main.go开头添加：beego.BConfig.Listen.HTTPPort = 5000（平台通常只开放5000端口） - 强制绑定公网地址：
beego.BConfig.Listen.HTTPAddr = "0.0.0.0"，避免因默认127.0.0.1导致服务不可达 - 如果仍想用
app.conf，确保它在构建后与二进制同级目录，并检查beego.LoadAppConfig("ini", "conf/app.conf")是否被调用
用 go mod 或 godep 固化依赖，别让部署时现场拉包
部署机器通常无外网访问权限，或代理不稳定。go get 在构建阶段失败会导致整个发布中断。
- Go 1.11+ 推荐用
go mod：go mod init your-app-name→go mod tidy→ 提交go.mod和go.sum - 老项目用
godep：先go get github.com/tools/godep，再在项目根目录执行godep save ./，生成Godeps/Godeps.json - 无论哪种方式，都必须把依赖文件（
go.mod或Godeps/）纳入 Git，否则 CI 拿不到版本锁定信息 - 构建命令统一用：
CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .（交叉编译为 Linux 二进制）
Procfile 或启动脚本里别漏掉环境变量和日志重定向
Beego 默认日志输出到 os.Stdout，但某些平台要求日志必须写入文件或按行刷出，否则看不到错误。
- 在
Procfile（如 Heroku 风格）中写：web: ./app -logtostderr=true，确保日志不缓冲 - 若平台不支持命令行参数，改代码：
beego.SetLogger("console", `{"level":4}`)，其中4是LevelError，避免调试日志刷屏 - 设置关键环境变量：
export GIN_MODE=release类似逻辑不适用 Beego，但要设export BEEGO_RUNMODE=prod来关闭 dev 模式特性（如热重载、文档自动生成） - 检查
conf/app.conf中是否有runmode = dev，生产环境务必改为prod，否则可能暴露敏感信息或性能下降
最容易被忽略的是：Beego v2 的 import 路径已变，旧项目升级后 github.com/astaxie/beego 会报错，必须改成 github.com/beego/beego/v2，且所有 beego. 调用前缀不变——这个兼容层容易让人误以为没改对。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
