多Django项目共享模型时related_query_name在非默认库项目失效

核心原因推测 #

你的问题大概率和数据库路由、模型元数据加载有关：项目B未将共享数据库设为默认，导致查询User模型时默认走了其他数据库，而该数据库没有Post模型的关联元数据，因此无法识别post这个反向查询关键字。

具体解决步骤 #

• 显式指定查询的数据库
  在项目B中查询时，强制指定使用共享数据库，确保加载对应模型的关联元数据：

  User.objects.using('你的共享数据库别名').filter(post=[任意条件])
  

• 配置数据库路由规则
  给项目B添加数据库路由，让User和Post模型的所有读操作都路由到共享数据库：

  1. 创建路由文件（如db_routers.py）：

  class SharedDBRouter:
      def db_for_read(self, model, **hints):
          if model.__name__ in ['User', 'Post']:
              return '共享数据库别名'
          return None
  
      def db_for_write(self, model, **hints):
          # 项目B仅读取数据，禁止写操作
          return None
  
      def allow_relation(self, obj1, obj2, **hints):
          if obj1.__class__.__name__ in ['User', 'Post'] or obj2.__class__.__name__ in ['User', 'Post']:
              return True
          return None
  

  2. 在settings.py中配置路由：

  DATABASE_ROUTERS = ['your_project.db_routers.SharedDBRouter']
  

• 确认模型所在App已加入INSTALLED_APPS
  确保项目B的INSTALLED_APPS里包含定义User和Post模型的App，否则Django不会加载模型的完整元数据（包括related_query_name配置）。

• 验证模型表名一致性
  检查项目B中User和Post模型的db_table设置是否与项目A完全一致，避免因表名不匹配导致关联查询失败。

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