Django部署到Heroku时static文件夹内Excel文件找不到问题咨询

核心问题定位 #

你代码的核心错误是生产环境下static()函数返回的是静态资源的HTTP访问URL，不是服务器本地的文件系统路径，你把URL传给读取本地Excel的函数，当然找不到文件。

排查步骤 #

• 先在Heroku后台临时把DEBUG设为True，测试功能是否正常，确认是静态文件路径读取逻辑的问题，不是文件未被收集的问题
• 执行命令heroku run bash进入部署容器，查看staticfiles目录下是否存在excel/sport_update.xlsx文件，确认collectstatic执行时正常把static目录的文件收集到了目标位置
• 打印生产环境下get_static(path)的返回值，你会看到返回的是/static/excel/sport_update.xlsx这类URL字符串，不是本地文件路径

具体解决方法 #

1. 改写get_static函数，生产环境也返回本地文件路径 #

不要用static()函数，生产环境静态文件被统一收集到STATIC_ROOT目录下，直接拼接路径即可：

from django.conf import settings
from django.contrib.staticfiles.finders import find
from pathlib import Path

def get_static(path):
    if settings.DEBUG:
        return find(path)
    else:
        return Path(settings.STATIC_ROOT) / path

2. 修正路径分隔符问题 #

不要用Windows特有的反斜杠\，统一用正斜杠/，避免Linux系统下路径识别失败：

# 修正前
path = 'excel\sport_update.xlsx'
# 修正后
path = 'excel/sport_update.xlsx'

3. 确认Heroku静态文件收集配置正常 #

检查你的Procfile文件，确保发布流程会执行静态文件收集，如果没有自动执行，可以在release命令中手动添加：

release: python manage.py collectstatic --noinput
web: gunicorn 你的项目名.wsgi --log-file -

4. 可选优化 #

如果后续有大量需要服务端读取的静态数据文件，建议单独新建data目录存储，不要和前端静态资源混放，配置MEDIA_ROOT来管理这类资源，逻辑会更清晰。

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