Django单元测试：如何覆盖urls.py依赖的配置项以测试不同端点注册逻辑

你遇到的核心问题其实是Django的URL配置在整个测试进程启动时就一次性加载完成了——哪怕你用override_settings修改了DEMO配置，后续也不会触发urls.py的重新解析。所以你的测试里虽然settings.DEMO变成了True，但实际的urlpatterns还是进程启动时生成的那套（也就是DEMO=False的状态），自然访问不到端点，返回404。

我给你两个实用的解决方案，你可以根据自己的场景选择：

方案一：测试中动态修改urlpatterns（轻量直接） #

这个思路很简单：在每个测试方法里，根据当前的DEMO设置，手动添加/移除对应的URL规则，测试完成后再清理，避免影响其他测试用例。

修改你的测试代码如下：

# test.test_my_demo_endpoint.py
from django.conf import settings
from django.test import TestCase, override_settings
from django.urls import path
from myapp.views import MyDemoAPIView  # 替换成你实际的视图导入路径
from django.conf.urls import urlpatterns  # 导入全局的urlpatterns

class MyDemoEndpointTestCase(TestCase):
    @override_settings(DEMO=True)
    def test_endpoint_is_reachable_with_demo_equals_true(self):
        # 检查端点是否已存在，避免重复添加
        endpoint_exists = any(p.pattern == 'my_demo_endpoint/' for p in urlpatterns)
        if not endpoint_exists:
            # 手动添加DEMO端点
            urlpatterns.append(
                path('my_demo_endpoint/', MyDemoAPIView.as_view(), name="my-demo-view")
            )
        
        response = self.client.get("/my_demo_endpoint/")
        self.assertEqual(response.status_code, 200)

        # 测试后清理，移除添加的端点
        for idx, pattern in enumerate(urlpatterns):
            if pattern.pattern == 'my_demo_endpoint/':
                del urlpatterns[idx]
                break

    @override_settings(DEMO=False)
    def test_endpoint_is_not_reachable_with_demo_equals_false(self):
        # 确保端点不在urlpatterns里
        for idx, pattern in enumerate(urlpatterns):
            if pattern.pattern == 'my_demo_endpoint/':
                del urlpatterns[idx]
                break
        
        response = self.client.get("/my_demo_endpoint/")
        self.assertEqual(response.status_code, 404)

方案二：将URL生成逻辑封装为可调用函数（更优雅，适合复杂场景） #

如果你的URL配置逻辑比较复杂，或者后续可能有更多开关控制的端点，推荐把URL生成逻辑封装成函数，这样在测试中可以重新调用它来生成新的urlpatterns。

第一步：修改urls.py，重构URL生成逻辑 #

# urls.py
from django.conf import settings
from django.urls import path
from myapp.views import MyDemoAPIView  # 你的视图

def get_urlpatterns():
    # 基础URL配置
    urlpatterns = [
        # 这里放你原本的非条件URL规则
        # path('normal_endpoint/', NormalView.as_view(), name="normal-view"),
    ]
    
    if settings.DEMO:
        urlpatterns.append(
            path('my_demo_endpoint/', MyDemoAPIView.as_view(), name="my-demo-view")
        )
    return urlpatterns

# 初始化URL配置
urlpatterns = get_urlpatterns()

第二步：修改测试代码，重新加载URL配置 #

# test.test_my_demo_endpoint.py
from django.conf import settings
from django.test import TestCase, override_settings
from django.urls import clear_url_caches, set_urlconf
from myapp.urls import get_urlpatterns, urlpatterns as myapp_urlpatterns

class MyDemoEndpointTestCase(TestCase):
    @override_settings(DEMO=True)
    def test_endpoint_is_reachable_with_demo_equals_true(self):
        # 清除Django的URL缓存，避免使用旧配置
        clear_url_caches()
        # 重新生成并替换urlpatterns
        myapp_urlpatterns[:] = get_urlpatterns()
        # 告诉Django使用更新后的URL配置
        set_urlconf('myapp.urls')
        
        response = self.client.get("/my_demo_endpoint/")
        self.assertEqual(response.status_code, 200)

    @override_settings(DEMO=False)
    def test_endpoint_is_not_reachable_with_demo_equals_false(self):
        clear_url_caches()
        myapp_urlpatterns[:] = get_urlpatterns()
        set_urlconf('myapp.urls')
        
        response = self.client.get("/my_demo_endpoint/")
        self.assertEqual(response.status_code, 404)

为什么这个方案更优？ #

• 保持了URL配置逻辑的单一性：所有的URL规则都在get_urlpatterns里维护，不用在测试里重复写一遍URL规则
• 扩展性好：后续如果加更多开关控制的端点，只需要修改get_urlpatterns，测试代码不需要大改

备注：内容来源于stack exchange，提问作者Jean Bouvattier