Beego应用Docker启动失败主因是资源未打包或路径错配；须用多阶段构建编译二进制，显式COPY conf/views/static，设runmode=prod，并确保WORKDIR与views_path等相对路径一致。
Beego 应用在 Docker 中跑不起来，八成不是框架问题，而是构建阶段没把 conf、views、static 这些非 Go 文件打进镜像，或者运行时工作目录和路径配置对不上。生产环境必须用二进制部署，别用 bee run。
为什么不能直接用 bee run 构建镜像
开发时用 bee run 是为了热重载，但它的依赖（如 bee 工具本身、Go 编译器、源码）全留在镜像里，导致镜像臃肿（>1GB），且无法在无 Go 环境的生产机上运行。更关键的是：bee run 默认从当前目录读 conf/app.conf，而 Docker 容器启动后工作目录可能不是你预期的位置，容易报 open conf/app.conf: no such file or directory。
正确做法是：只在构建阶段用 Go 环境编译出单个二进制，运行阶段用精简的 alpine 或 scratch 镜像加载它。
- 构建阶段用
golang:1.21-alpine（带编译工具） - 运行阶段用
alpine:latest（仅含运行时依赖） - 确保
COPY操作包含conf/、views/、static/目录 - 二进制启动前，用
ls -l或pwd在ENTRYPOINT里临时验证路径
app.conf 中的 runmode 和路径必须显式设为 prod
Beego 默认是 dev 模式，会开启日志调试、模板热编译、自动 reload —— 这些在容器里不仅无效，还可能因文件系统只读而 panic。必须在 conf/app.conf 里写死：
runmode = prod httpport = 8080 appname = my-beego-app views_path = views static_path = static
注意：views_path 和 static_path 是相对路径，Beego 会以**当前工作目录**为基准拼接。所以 Dockerfile 中的 WORKDIR 必须和这些路径的父级一致，例如：
WORKDIR /app- 则
views_path = views→ 实际找/app/views/ - 构建时
COPY views/ /app/views/才能命中
多阶段构建中如何安全复制非 Go 资源
常见错误是只 COPY *.go 或 COPY . .，结果 views/ 被 .gitignore 忽略，或 conf/app.conf 因本地开发配置含敏感信息被漏掉。推荐明确声明要复制的内容：
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-bin . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/beego-bin . COPY --from=builder /app/conf ./conf/ COPY --from=builder /app/views ./views/ COPY --from=builder /app/static ./static/ EXPOSE 8080 CMD ["./beego-bin"]
这样既避免泄露 .git 或 node_modules，又确保资源路径与代码中 beego.SetViewsPath() 的调用逻辑一致。
容器启动后端口不通或 404 的排查顺序
运行 docker run -p 8080:8080 my-beego 后访问 localhost:8080 报错，按这个顺序查：
- 看容器日志：
docker logs <container-id>，确认是否输出Starting Beego...和监听地址（应为0.0.0.0:8080，不是127.0.0.1:8080） - 进容器检查文件是否存在：
docker exec -it <container-id> ls -l /root/conf/app.conf /root/views/index.tpl - 确认 Beego 是否读到配置：
docker logs中是否有[INFO] RunMode = prod - 检查防火墙：宿主机若开防火墙，需放行映射端口（如
firewall-cmd --add-port=8080/tcp --permanent） - Beego 默认路由是
/对应controllers.DefaultController，如果删了default.go又没配新路由，必然 404
最常被忽略的一点：Beego 的 app.conf 中 httpport 值必须和 EXPOSE、-p 三者一致，否则它监听的端口根本没暴露出来。
