Django拆分models为子文件夹后配置syndication框架出现模型冲突如何解决

问题根因 #

模型冲突是因为Django模型注册表中识别到两个不同导入路径指向同一个News模型，本质是AppConfig配置的应用名和实际导入路径不匹配，加上模型导入路径不统一触发的重复注册：

• 你在INSTALLED_APPS中注册的是带apps.前缀的应用配置
• 但ArticlesConfig中的name字段只写了articles，没有带前缀，导致Django同时识别到articles和apps.articles两个路径下的同一模型

解决步骤 #

1. 修正AppConfig的name配置
   修改/apps/articles/apps.py中的name字段，补全完整的应用路径：

from django.apps import AppConfig

class ArticlesConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'apps.articles' # 与INSTALLED_APPS里的应用路径保持一致

2. 补全models子包的导出配置
   在/apps/articles/models/__init__.py中显式导出所有拆分的模型，统一导入入口：

from .news import News
from .articles import Articles
from .categories import Category
from .reviews import Review
from .tags import Tag
# 所有拆分的模型都在这里显式导出

3. 统一模型导入路径
   把所有直接导入子模块模型的写法，改为从models包统一导入，比如修改feeds.py中的导入语句：

# 删掉原来的 from .models.news import News
from .models import News

4. 清理冗余配置
   删除News模型Meta中手动添加的app_label = 'articles'配置，AppConfig配置正确的情况下不需要手动指定app_label，避免额外的路径冲突。

修改完成后重启服务即可恢复正常。

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