Beego项目容器化必须设runmode=prod，否则dev模式的热重载、调试面板等机制在容器中会因缺失源码路径或权限问题导致panic；Dockerfile须用多阶段构建，编译阶段用golang镜像，运行阶段用alpine等轻量镜像并禁用CGO以生成静态二进制。
Beego 项目必须设为 runmode = prod 才能正常容器化运行
开发模式下 Beego 会启用热重载、调试面板、文件监控等机制，这些在容器里不仅无效，还会因找不到源码路径或 watcher 权限问题直接 panic。常见错误是容器启动后立即退出，日志里出现 panic: open conf/app.conf: no such file or directory 或 watcher start error。
正确做法是在 conf/app.conf 中显式指定：
-
runmode = prod（必改，否则默认是 dev） -
httpport = 8080（避免硬编码端口，后续映射更可控） -
appname = mybeegoapp（建议设明确名称，方便日志识别） - 删掉或注释掉
autorender = true、recoverypanic = true等 dev-only 配置项
验证方式：本地执行 go run main.go 前先临时改回 dev，确认报错；改回 prod 后应能静默启动并监听端口。
Dockerfile 要用多阶段构建，别直接用 golang:latest 运行时镜像
直接在 golang 镜像里 go build 再 ENTRYPOINT，会导致镜像体积大（含 Go 工具链、源码、缓存）、攻击面宽、启动慢。生产环境应分离构建与运行阶段。
推荐写法（以 amd64 Linux 为例）：
FROM golang:1.21-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o beego-app . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/beego-app . EXPOSE 8080 CMD ["./beego-app"]
关键点：
-
CGO_ENABLED=0确保生成纯静态二进制，避免容器里缺 libc - 用
alpine作运行镜像，最终镜像通常 golang 镜像常超 900MB - 别漏掉
ca-certificates，否则 Beego 的 HTTPS 请求（如调第三方 API）会失败
容器内 Beego 找不到 views 和 static 目录的根因是工作路径错位
Beego 默认从当前工作目录找 views/、static/、conf/。但 Docker 容器启动时，WORKDIR 和二进制实际位置不一致，就会报 template: not found 或 404 静态资源。
解决方法不是靠 COPY 把目录塞到奇怪路径，而是让代码主动适配容器环境：
- 在
main.go开头加初始化逻辑，用os.Executable()反推根路径：
func init() {
ex, _ := os.Executable()
root := filepath.Dir(filepath.Dir(ex)) // 假设二进制在 /root/beego-app，则 root 是 /root
beego.SetViewsPath(filepath.Join(root, "views"))
beego.SetStaticPath("/static", filepath.Join(root, "static"))
beego.LoadAppConfig("ini", filepath.Join(root, "conf", "app.conf"))
}
- 确保
Dockerfile中COPY把views/、static/、conf/和二进制放在同一级目录（比如都 COPY 到/root/） - 别依赖
bee run—— 它只适合开发，容器里必须用编译后的二进制
docker run 启动时必须显式暴露端口并挂载配置卷（如果需外部修改）
Beego 应用监听的是容器内网口（如 0.0.0.0:8080），但宿主机访问不到，除非用 -p 映射。另外，硬编码在镜像里的 app.conf 无法动态调整数据库地址或密钥，必须支持外部覆盖。
典型启动命令：
docker run -d \ --name my-beego-app \ -p 8080:8080 \ -v $(pwd)/conf-prod/app.conf:/root/conf/app.conf:ro \ -v $(pwd)/uploads:/root/uploads \ --restart=unless-stopped \ my-beego-image:latest
注意：
-
:ro表示只读挂载配置文件，防容器内误改 -
uploads这类可变目录必须挂载宿主机路径，否则容器重启后上传文件就丢了 - 别用
--network host—— 虽省事但破坏网络隔离，且在 macOS/Windows Docker Desktop 上不生效 - Beego 日志默认输出到 stdout，可直接用
docker logs -f my-beego-app查看
真正容易被忽略的，是 Beego 的 app.conf 里所有路径（比如 logpath、viewspath）都得写相对路径或基于 APP_PATH 变量，一旦写死绝对路径（如 /home/user/myproject/views），容器里必然失效。容器不是虚拟机，没有“用户家目录”的概念。
