Django URL模板标签生成URL缺失基础地址末尾字符问题排查

核心问题 #

使用{% url 'product' %}生成的URL中，基础路径/deck被错误生成为/dec，缺失最后一个字母，以下是几个关键排查方向：

1. 检查Django全局配置 #

打开settings.py，查看是否设置了FORCE_SCRIPT_NAME参数：

# 错误示例
FORCE_SCRIPT_NAME = '/dec'

# 正确配置（匹配你的基础地址）
FORCE_SCRIPT_NAME = '/deck'

这个参数会强制所有URL生成时使用指定的前缀，若配置错误会直接导致路径异常。

2. 排查反向代理配置（如Nginx/Apache） #

如果你的项目通过反向代理部署，检查代理服务器的路径配置：

• Nginx示例：确认location和proxy_pass中的路径是否正确，避免把/deck写成/dec：

location /deck {
    proxy_pass http://127.0.0.1:8000/deck;
    # 其他代理配置...
}

• Apache示例：检查ProxyPass和ProxyPassReverse的路径是否匹配预期的/deck。

3. 检查WSGI服务器配置 #

如果使用uWSGI、Gunicorn等WSGI服务，查看启动参数或配置文件中的script-name设置：

• uWSGI示例：若启动时指定了--mount /dec=myproject.wsgi:application，需改为--mount /deck=myproject.wsgi:application。

4. 清理缓存 #

• 清除浏览器缓存，避免旧的错误URL被缓存显示；
• 重启Django服务，确保配置修改生效；
• 若启用了Django模板缓存，可执行python manage.py clearcache清理模板缓存。

额外提示：修复静态文件配置错误 #

你的项目urls.py中静态文件配置存在错误，MEDIA_URL对应的document_root应该是settings.MEDIA_ROOT，而非settings.STATIC_ROOT，修正后：

urlpatterns = [
    # ... 其他路径配置
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

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