部署在AWS ECR+Fargate的Flask应用加载静态文件报错404是什么原因？

1. Docker镜像打包错误（概率最高） #

• 静态文件夹未被复制到镜像：检查你的Dockerfile是否漏写了static目录的复制指令，正确的配置应该包含类似如下行：

COPY static ./static
COPY templates ./templates
COPY app.py .

很多开发者只复制了app.py和templates目录，导致容器内不存在static文件夹，自然返回404。

• 工作目录匹配错误：如果Dockerfile中指定了WORKDIR，要确认所有文件复制的目标路径和工作目录匹配，Flask默认会从启动进程的工作目录下找static文件夹。
• 静态文件权限不足：容器运行时使用的非root用户没有static目录的读取权限，也会触发404，可在Dockerfile中增加权限配置：

RUN chmod -R 755 ./static

2. Flask自身静态资源配置问题 #

• 确认Flask初始化时没有修改默认的静态资源配置，比如不要显式设置static_folder=None、static_url_path为非默认值。如果你的应用挂载在域名的子路径下（比如ALB配置了转发/myapp/*到服务），需要配置Flask的APPLICATION_ROOT，或者设置WSGI的SCRIPT_NAME环境变量，保证url_for生成的静态资源路径前缀正确：

app.config['APPLICATION_ROOT'] = '/myapp'

• 如果生产环境使用Gunicorn/uWSGI等WSGI服务器替代app.run启动，确认启动命令的工作目录和app.py所在目录一致。

3. AWS侧路由配置错误 #

• ALB路径转发规则不全：DevOps可能只配置了/home路径的转发规则，没有配置/static/*前缀的转发规则，导致静态资源请求没有被转发到Fargate服务，直接被ALB返回404。
• 若使用CloudFront、WAF等中间服务，确认没有规则拦截/static前缀的请求，或者缓存配置错误指向了不存在的资源。

快速验证方法 #

先在本地构建Docker镜像并运行，访问http://localhost:5000/static/css/styles.css看是否能正常返回：

• 如果本地镜像访问静态资源也404：问题出在Dockerfile或者Flask配置，优先排查第一、第二类问题
• 如果本地镜像正常：问题出在AWS侧的路由配置，联系DevOps调整ALB/网关的转发规则即可。

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