Go应用多阶段Docker构建运行时找不到已存在的.env文件排查
问题核心根因
- 多数Go项目加载.env文件的逻辑(比如godotenv库的默认加载方式)是基于相对路径查找,匹配的是进程启动时的当前工作目录,而非二进制文件本身的存放路径
- 当前runtime运行阶段没有显式配置工作目录,Alpine基础镜像启动进程的默认工作目录为容器根目录
/ - 直接通过CMD执行绝对路径的
/app/main时,进程会尝试读取/.env,但实际.env文件存放在/app/.env路径下,因此触发加载失败报错 - 交互模式下手动执行程序能正常运行,是因为排查时必然先执行了
cd /app进入二进制所在目录,此时进程的工作目录是/app,自然能匹配到同目录下的.env文件
修复方案
直接在runtime阶段增加工作目录配置,让启动进程的默认工作目录和文件存放路径保持一致即可,修改后的Dockerfile runtime段配置如下:
FROM alpine as runtime # 指定进程运行的工作目录 WORKDIR /app COPY --from=build /dist/main /app/ COPY --from=build /build/keys/* /app/keys/ COPY --from=build /build/.env /app/ # 配置WORKDIR后也可以直接使用相对路径启动,逻辑更统一 CMD ["./main"]
可选优化项
- 原build阶段创建
/dist目录、手动执行cp拷贝文件的操作完全冗余:因为runtime阶段仅从build阶段的/dist拷贝了main二进制,其余的.env、密钥文件都是直接从build阶段的原始路径拷贝,那部分多余的cp操作会拉长镜像构建时间,可以全部删除 - 如果希望不受工作目录限制加载.env,也可以在Go代码里指定.env的绝对路径(比如
/app/.env),不过这种方式灵活性较差,不如统一配置工作目录的方案通用
内容的提问来源于stack exchange,提问作者Peter Nunn
相关产品推荐
相关产品推荐

