使用Docker部署含静态文件的Echo Web应用时模板文件找不到的问题排查

看起来你这是典型的Docker路径匹配问题，本地跑没问题但容器里找不到文件，我帮你分析下原因并给出修复方案：

问题核心 #

你本地运行go run server.go正常，是因为程序的工作目录就是site文件夹，相对路径public/views/*.html能正确找到模板。但Docker运行时，程序的工作目录和文件实际存放路径不匹配，导致模板找不到，触发了panic：

panic: html/template: pattern matches no files: `public/views/*.html`

具体原因 #

看你的Dockerfile最后阶段：

FROM alpine:3.12
COPY --from=builder /app/site /bin/.
ENTRYPOINT [ "server" ]

这里有两个关键问题：

1. 工作目录不匹配：容器默认的工作目录是/，你执行server时，程序会在/目录下找public/views/*.html，但你的public文件夹实际被复制到了/bin/public，路径完全对不上。
2. 冗余文件复制：你把整个site目录（包括server.go、go.mod这些编译时文件）都复制到了容器里，不仅增大镜像体积，还没明确指定需要的资源文件位置。

修复后的Dockerfile #

调整运行阶段的配置，只复制必需文件并设置正确的工作目录：

FROM golang:1.15.2-alpine3.12 AS builder
WORKDIR /app
COPY . .
WORKDIR /app/site
RUN CGO_ENABLED=0 GOOS=linux go build -o server

FROM alpine:3.12
# 设置运行时工作目录为/bin，和文件存放位置对齐
WORKDIR /bin
# 仅复制编译好的二进制可执行文件
COPY --from=builder /app/site/server .
# 复制模板文件目录到当前工作目录的public下
COPY --from=builder /app/site/public ./public
# 复制静态资源目录
COPY --from=builder /app/site/static ./static
# 运行当前目录下的server
ENTRYPOINT [ "./server" ]

为什么这样能解决问题？ #

• WORKDIR /bin让程序运行时的工作目录和文件存放目录一致，此时public/views/*.html的相对路径就能正确指向/bin/public/views/*.html。
• 只复制运行必需的文件（二进制、模板、静态资源），既减少了镜像体积，也避免了路径混淆。

额外小提示 #

如果以后遇到类似的路径问题，可以在容器启动时先进入shell查看文件结构，比如：

docker run --rm -it gcr.io/${PROJECT_ID}/myapp sh

然后用ls、pwd等命令确认文件位置和工作目录，快速定位问题。

内容的提问来源于stack exchange，提问作者oiio