Django-storages对django-jet静态文件URL参数转义致未授权访问

问题分析 #

仅django-jet-reboot的静态文件URL中，签名参数的分隔符&被转义为&，导致DigitalOcean S3无法识别有效签名，返回未授权错误。其他静态文件URL正常，说明问题出在jet包的模板渲染逻辑或存储类对该包文件的处理差异。

解决方案 #

1. 修复jet模板的静态URL转义 #

django-jet-reboot的模板可能未对{% static %}标签的输出添加|safe过滤器，导致Django自动转义HTML特殊字符。

• 找到jet模板中引用静态文件的位置（通常在虚拟环境的venv/lib/pythonX.X/site-packages/jet/templates/目录下）
• 将所有静态URL引用修改为：

  {% static 'jet/path/to/file.css'|safe %}
  

• 或者修改jet的基础模板（如base.html），统一为静态URL添加|safe处理。

2. 自定义S3存储类强制修正URL #

如果修改模板不方便，可通过自定义存储类重写url方法，自动替换转义字符：

# 在你的Django项目中创建storage.py文件
from storages.backends.s3boto3 import S3Boto3Storage

class UnescapedS3Storage(S3Boto3Storage):
    def url(self, name, parameters=None, expire=None, http_method=None):
        raw_url = super().url(name, parameters, expire, http_method)
        # 将转义的&替换为原始&
        return raw_url.replace('&', '&')

然后在settings.py中替换默认存储类：

STATICFILES_STORAGE = 'your_project_name.storage.UnescapedS3Storage'

3. 清理并重新收集静态文件 #

collectstatic的文件覆盖警告可能导致部分静态文件未正确生成或缓存，执行以下步骤：

# 删除本地静态文件目录
rm -rf static/
# 强制清理并重新收集
python manage.py collectstatic --clear --noinput

4. 验证URL生成 #

在Django shell中手动验证URL是否正常：

python manage.py shell
from django.templatetags.static import static
print(static('jet/css/style.css'))

如果输出中仍有&，说明是模板渲染层的问题；如果输出正常，则检查模板是否有额外转义逻辑。

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