Django DRF路由报错：basename 'breach'已注册问题排查

django.core.exceptions.ImproperlyConfigured: Router with basename "breach" is already registered 错误的核心原因是DRF路由注册时，同一个basename被重复绑定。即使你没在URL配置中显式重复声明basename="breach"，当两个关联同一Breach模型的ViewSet自动推导basename时也会触发冲突——DRF默认会用模型类名的小写形式作为basename，两个操作Breach模型的ViewSet若未指定自定义basename，会共用"breach"这个值，导致重复注册。

• 检查URL配置文件，确认是否两次调用router.register()且均指定basename="breach"
• 若未显式指定basename，检查两个Breach相关ViewSet：是否均继承ModelViewSet（或其他自动推导basename的ViewSet类）且关联同一Breach模型，此时DRF会自动生成重复的basename
• 排查是否存在重复实例化Router的情况：比如在多个URL文件中创建DefaultRouter实例并注册同一basename的路由，最终被主URL文件引入导致冲突

方法1：为其中一个ViewSet指定唯一的自定义basename #

在注册路由时显式声明不同的basename，避免冲突：

# urls.py 示例
from rest_framework.routers import DefaultRouter
from .views import BreachViewSet, BreachStatsViewSet

router = DefaultRouter()
# 第一个ViewSet可使用自动推导的basename（即"breach"）
router.register(r'breaches', BreachViewSet)
# 第二个ViewSet指定自定义basename
router.register(r'breach-stats', BreachStatsViewSet, basename='breach-stats')

urlpatterns = [
    path('', include(router.urls)),
    # 其他路由配置
]

方法2：为两个ViewSet都显式指定不同的basename #

如果需要更清晰的命名，可给两个ViewSet都设置唯一的basename：

router.register(r'breaches', BreachViewSet, basename='breach')
router.register(r'breach-exports', BreachExportViewSet, basename='breach-export')

方法3：检查并合并重复的Router实例 #

如果存在多个Router实例注册了同一路由，将所有路由注册到同一个Router实例中，避免重复导入导致的冲突。

启动前可通过打印Router的注册信息确认重复项：

# 在urls.py中添加打印语句
print(router.registered_basenames)

若输出包含两个"breach"，则说明确实存在重复注册，按上述方法修改即可。

内容的提问来源于stack exchange，提问作者Ahmed Wagdi