能否让Django runserver自动重载监控多组ROOT_URLCONF？

一、能否让runserver监控多组ROOT_URLCONF并触发自动重载？ #

可以实现。Django的runserver默认仅监控ROOT_URLCONF指定的文件，但通过自定义命令扩展监控范围，就能把第二组URLconf加入自动重载的监控列表。

二、该方案的合理性评估 #

开发环境下完全合理：

• 完美匹配你减少启动开销、提升开发便捷性的需求，无需同时启动两个服务器；
• 生产环境本来就要求独立部署WSGI和ASGI服务，开发阶段的这种配置不会干扰生产部署逻辑；
• 这类开发模式虽不算主流，但确实是很多开发者为了效率采用的折中方案，没有技术层面的硬伤。

三、具体实现步骤 #

1. 拆分URL配置文件 #

创建两组独立的URLconf文件：

• urls_wsgi.py：对应WSGI应用的HTTP路由
• urls_asgi.py：对应ASGI应用的WebSocket（或其他异步）路由

2. 配置settings参数 #

在settings.py中明确两组URLconf的路径：

# WGI应用默认路由
ROOT_URLCONF = 'your_project.urls_wsgi'
# ASGI应用专用路由
ASGI_ROOT_URLCONF = 'your_project.urls_asgi'

# 配置ASGI应用入口
ASGI_APPLICATION = 'your_project.asgi.application'

3. 修改ASGI应用配置 #

在asgi.py中区分HTTP和WebSocket的路由处理，分别对应两组URLconf：

import os
import importlib
from django.core.asgi import get_asgi_application
from channels.routing import ProtocolTypeRouter, URLRouter
from django.conf import settings

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project.settings')

# HTTP请求沿用WSGI的URLconf
django_asgi_app = get_asgi_application()

# 加载ASGI专用的URLconf
asgi_url_module = importlib.import_module(settings.ASGI_ROOT_URLCONF)
asgi_urlpatterns = getattr(asgi_url_module, 'urlpatterns', [])

application = ProtocolTypeRouter({
    "http": django_asgi_app,
    "websocket": URLRouter(asgi_urlpatterns),
})

4. 自定义runserver命令实现多URLconf监控 #

在你的某个app下创建management/commands/runserver_multi.py文件，继承默认runserver命令并添加额外监控文件：

from django.core.management.commands.runserver import Command as RunserverCommand
from django.conf import settings
import importlib

class Command(RunserverCommand):
    def handle(self, *args, **options):
        # 导入ASGI URLconf模块并获取其文件路径
        asgi_urlconf = getattr(settings, 'ASGI_ROOT_URLCONF', '')
        if asgi_urlconf:
            module = importlib.import_module(asgi_urlconf)
            self.watched_files.append(module.__file__)
        # 调用原runserver逻辑
        super().handle(*args, **options)

5. 启动服务 #

用自定义命令启动runserver：

python manage.py runserver_multi

此时修改urls_wsgi.py或urls_asgi.py都会触发自动重载。

四、注意事项 #

• 确保两组URLconf的路由逻辑不冲突，比如WebSocket路由不要和HTTP路由的路径重叠，避免调试混淆；
• 自定义的runserver_multi命令仅用于开发环境，生产环境仍需按标准方式分别部署WSGI（如Gunicorn）和ASGI（如Daphne）服务；
• 如果你的ASGI应用还有其他异步任务（如Channels的消费者文件），runserver默认会监控INSTALLED_APPS下的文件，修改消费者代码也会自动重载，无需额外配置。

内容的提问来源于stack exchange，提问作者800c25d6-cd74-11ed-afa1-0242ac