Django Admin表单中如何为媒体文件添加未编码的查询字符串参数

我之前刚好碰到过一模一样的问题——Django会自动把Media类里静态文件路径的特殊字符（比如?）编码成%3F，导致版本号参数失效。下面给你两个可行的解决方案，适配你用Git哈希做版本号的场景：

方案一：手动拼接完整静态URL（推荐） #

Django对Media路径编码的核心原因是：它会把你传入的相对路径当作静态文件的路径部分，用static模板标签处理时会自动编码特殊字符。要绕过这个，我们可以先通过static函数生成正确的静态文件基础URL，再手动拼接版本号参数，这样整个字符串会被当作完整URL，不会再被编码。

步骤如下：

1. 在你的admin文件里导入需要的模块：

from django.templatetags.static import static
from django.conf import settings

2. 修改Media类的写法：

class Media:
    js = [
        static('scripts/my_file.js') + f'?{settings.STATIC_COMMIT}',
    ]

这样static('scripts/my_file.js')会生成正确的静态文件URL（比如/static/scripts/my_file.js），然后我们把Git哈希参数直接拼在后面，Django会直接使用这个完整URL，不会再对?进行编码。

方案二：使用Django自带的静态文件哈希（替代方案） #

如果你不想手动处理版本号，其实Django自带了静态文件哈希功能，能自动给静态文件名加上哈希后缀（比如my_file.abc1234.js），同样能实现缓存刷新的效果。只需要在settings.py里配置：

STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'

运行python manage.py collectstatic后，Django会自动生成带哈希的静态文件，你在Media类里只需要写原始路径就行：

class Media:
    js = ['scripts/my_file.js', ]

不过这个方案会改变静态文件的文件名，如果你已经习惯用Git哈希做版本号，方案一更贴合你的需求。

为什么原来的写法会被编码？ #

简单说，Django的Media类默认把你传入的字符串当作静态文件的路径，而不是完整URL。静态文件路径本身不应该包含查询参数，所以static标签会把?这类特殊字符编码成URL安全的格式，导致你的版本号参数失效。而我们手动拼接完整URL后，Django会识别这是一个完整的资源地址，不会再进行路径编码处理。

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