Django应用迁移至子路径后如何修正内部链接根路径

问题根因 #

你遇到的跳转丢/myapp前缀的问题，是因为mod_wsgi透传的路径前缀没有被Django的URL反向生成逻辑正确识别，这类场景是Django从3.0版本就原生支持适配的标准部署场景，完全不需要逐页修改模板内容。

针对你提出的四个问题的直接答复 #

• Django是否内置支持这类子路径部署场景？
  完全支持。Django 3.0及以上版本针对WSGI服务器的脚本别名部署场景提供了完整的适配能力，不需要引入任何第三方依赖就能实现正常的链接生成。
• 能否仅通过settings.py的全局配置解决问题？
  绝大多数常规部署场景下，只需要在settings.py调整1-2个全局配置项就能彻底解决，不需要改动业务逻辑、视图代码或者Apache的核心路由配置。
• 是否需要逐页修改模板内的所有链接？
  完全不需要。只要你的模板没有硬编码写死不带前缀的绝对路径，所有使用Django内置{% url %}标签、或者reverse()方法生成的内部链接，配置生效后会自动携带子路径前缀，零模板改动就能正常工作。
• 该场景下的最优落地方式是什么？
  结合你当前Apache + mod_wsgi + Django 3.1的技术栈，最小改动的配置方案就能彻底解决问题，同时还能保证本地开发环境的路径逻辑不受影响。

分步配置操作 #

1. 确认Apache端mod_wsgi的透传配置没有异常 #

你已经配置了WSGIScriptAlias /myapp /path/to/myapp/wsgi.py，需要排查两个常见的配置坑：

• 不要在Apache配置里叠加额外的路径重写规则（比如.htaccess里写的把/myapp下的请求重写到根路径的规则），这类规则会把SCRIPT_NAME环境变量覆盖为空，导致Django识别不到子路径前缀
• 确认没有手动关闭mod_wsgi的环境变量透传功能，正常情况下mod_wsgi会自动把WSGIScriptAlias配置的路径值写入WSGI环境的SCRIPT_NAME变量，不需要手动做额外适配

提醒：很多人配置完WSGIScriptAlias后，还会额外在Apache层写路径重写规则去掉/myapp前缀，这类操作是导致Django链接生成异常的最常见原因，完全不需要做。

2. 调整settings.py的全局配置 #

针对你用的Django 3.1版本，只需要新增一个核心配置项就能解决90%的链接异常问题：

# settings.py 新增配置
FORCE_SCRIPT_NAME = '/myapp'

这个配置的作用是强制Django所有URL反向生成逻辑（包括reverse()、{% url %}标签、静态文件路径生成）统一在URL前拼接指定的前缀，从根源上避免链接跳转丢失/myapp的问题。
配置完成后只需要补充检查两个细节：

• 不要在Django的根URL路由文件（urls.py）里手动添加/myapp的路由前缀，否则会出现路径重复拼接（比如最终生成的链接变成/myapp/myapp/catalog）
• 静态文件的STATIC_URL保持默认的/static/即可，Django会自动结合FORCE_SCRIPT_NAME的值生成正确的静态文件访问路径，不需要手动改成/myapp/static/

3. 例外场景的处理 #

如果配置完成后仍有部分链接跳转异常，只需要排查两类内容：

• 模板里硬编码的绝对路径链接（比如直接写<a href="/catalog">目录页</a>），这类链接没有经过Django的URL生成逻辑，是Django配置无法覆盖的，需要把这类硬编码链接替换为{% url 'catalog' %}的动态生成形式
• 前端通过原生JS拼接的绝对路径，这类路径如果是直接从根路径开始拼接的，需要调整为相对路径，或者读取全局的前缀变量生成正确地址

注意：FORCE_SCRIPT_NAME配置不会影响本地开发环境的使用，本地通过runserver启动服务时，Django会自动忽略这个配置，保持根路径访问的默认行为，不需要为了生产环境改动本地开发的配置逻辑。

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