Rails /public目录HTML文件无法在Docker容器中生效求助

1. 检查Dockerfile的文件拷贝逻辑 #

如果用了多阶段构建，务必在最终的Nginx阶段把Rails项目里的错误页面拷贝到Nginx的静态目录（一般是/usr/share/nginx/html）。示例配置：

# Rails构建阶段
FROM ruby:3.3.7 AS builder
WORKDIR /app
COPY . .
RUN bundle install
RUN rails assets:precompile

# Nginx最终阶段
FROM nginx:alpine
# 从builder阶段拷贝错误页面
COPY --from=builder /app/public/404.html /usr/share/nginx/html/
COPY --from=builder /app/public/500.html /usr/share/nginx/html/
# 拷贝Nginx配置
COPY nginx.conf /etc/nginx/conf.d/default.conf

还可以在builder阶段加个验证步骤，确认文件存在：

RUN ls -l /app/public/404.html /app/public/500.html

2. 修正.dockerignore规则 #

如果你的.dockerignore里有/public/*这类宽泛的忽略规则，必须把例外规则写在它后面，否则会被覆盖。正确写法：

# 先忽略public下其他文件
/public/*
# 再保留需要的错误页面
!/public/404.html
!/public/500.html

要是没有/public/*这种规则，单独加例外规则没用，因为默认不会忽略整个public目录。

3. 验证Rails构建过程 #

Rails API模式默认禁用静态文件服务，但不影响构建时的文件保留。查看构建日志，确认这两个html文件没有被删除。如果rails assets:precompile会清理文件，可以在构建后手动复制这两个文件到public目录，或者在assets:precompile命令后追加复制步骤。

4. 检查Nginx配置 #

确保nginx.conf里正确指向了错误页面：

server {
  listen 80;
  server_name localhost;

  error_page 404 /404.html;
  error_page 500 /500.html;

  location = /404.html {
    root /usr/share/nginx/html;
    internal;
  }

  location = /500.html {
    root /usr/share/nginx/html;
    internal;
  }

  # 其他反向代理Rails的配置...
}

重点确认root路径和你拷贝文件的目录一致，启动容器后可以进入容器检查文件是否存在：

docker exec -it your-container-name ls -l /usr/share/nginx/html/

5. ECS Fargate部署验证 #

本地构建镜像后，先启动容器确认文件存在：

docker run --rm your-image-name ls -l /usr/share/nginx/html/404.html /usr/share/nginx/html/500.html

如果本地没问题，那问题可能出在ECS镜像推送或部署环节——检查镜像标签是否为最新版本，ECS任务定义里的镜像地址是否正确，确保拉取的是刚构建的镜像。

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