Docker部署Flask静态站点出现空白页面问题求助

核心问题是本地运行正常但Docker部署后静态资源加载失败、页面空白，结合你的代码环境，主要排查方向集中在静态资源引用方式和Flask静态文件配置上。

1. 静态资源引用方式错误（最可能原因） #

你将Flask的static_folder设为templates/assets，但如果HTML模板里直接用相对路径（比如assets/css/style.css）引用静态资源，会导致Docker环境下路径解析异常。

修正方法：用Jinja2的url_for生成正确URL #

把index.html和p5.html里所有静态资源的引用替换为url_for生成的路径：
原引用示例：

<link rel="stylesheet" href="assets/css/main.css">
<script src="assets/js/app.js"></script>

替换为：

<link rel="stylesheet" href="{{ url_for('static', filename='css/main.css') }}">
<script src="{{ url_for('static', filename='js/app.js') }}"></script>

url_for('static', filename='xxx')会自动根据你设置的static_folder生成正确路径，避免相对路径在不同环境下的解析问题。

2. 验证容器内文件结构 #

执行以下命令确认容器内静态文件是否存在：

# 查看运行中容器ID
docker ps
# 进入容器检查文件
docker exec -it <你的容器ID> ls /usr/src/app/templates/assets

如果assets目录文件缺失，检查Docker构建过程是否报错，或本地文件是否遗漏。

3. 可选：调整静态URL路径配置 #

如果希望静态资源URL和本地一致（比如/assets/xxx），可以在初始化Flask时添加static_url_path参数：

app = Flask(__name__, 
            static_folder='templates/assets',
            static_url_path='/assets')

这样用/assets/css/main.css这类绝对路径也能访问，但仍推荐用url_for保证兼容性。

4. 开启调试模式查日志 #

临时开启调试模式获取详细错误信息：
修改app.run代码：

if __name__ == "__main__":
    app.run(host="0.0.0.0", 
            port=int(os.environ.get("PORT", 5000)),
            debug=True)

重新构建镜像并运行后，用docker logs <容器ID>查看日志，定位具体错误。

验证流程 #

1. 修改HTML模板的静态资源引用为url_for格式
2. 重新构建镜像：docker build -t <你的用户名>/<镜像名> .
3. 运行容器：docker run -p 8888:5000 <你的用户名>/<镜像名>
4. 访问localhost:8888检查页面及静态资源加载情况

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