Django 5.x 中 OneToOneField 和 ManyToManyField 的反向查找（如 switch__config_state）报错，根本原因是模型中手动指定的 app_label 未在 INSTALLED_APPS 中注册，导致 Django 无法识别关联关系。
django 5.x 中 onetoonefield 和 manytomanyfield 的反向查找（如 `switch__config_state`）报错，根本原因是模型中手动指定的 `app_label` 未在 `installed_apps` 中注册，导致 django 无法识别关联关系。
在 Django 5.x 中，反向关系（reverse lookup）的解析机制相比 3.x 更加严格：Django 不再容忍“游离”的模型定义——即通过 app_label 显式声明归属但该应用未被激活（未出现在 INSTALLED_APPS 中）。你提供的模型代码中：
class ConfigState(models.Model):
switch = models.OneToOneField(Switch, models.CASCADE, db_column='switch', primary_key=True,
related_name='config_state')
class Meta:
managed = False
db_table = 'ConfigState'
app_label = 'myapp_models' # ⚠️ 问题根源app_label = 'myapp_models' 意味着 Django 将该模型视为属于名为 myapp_models 的 Django 应用。但若 settings.py 中 未将 'myapp_models' 加入 INSTALLED_APPS，Django 就无法完成模型元数据的完整注册，尤其会跳过反向关系（related_name）的解析与索引。因此，当执行 EdgeSwitch.objects.filter(switch__config_state=1) 时，Django 在尝试解析 switch__config_state 这一跨模型路径时，发现 Switch.config_state 关系不存在（因 ConfigState 未被正确挂载），最终抛出：
FieldError: Unsupported lookup 'config_state' for OneToOneField or join on the field not permitted.
✅ 正确做法是 移除所有不必要的 app_label 声明，让 Django 自动推导归属应用：
# models.py（推荐写法，无需 app_label）
from django.db import models
class Switch(models.Model):
fqdn = models.CharField(max_length=45, unique=True)
class Meta:
managed = False
db_table = 'Switch'
# ✅ 删除 app_label —— 模型自动归属当前应用（如 'myapp'）
class ConfigState(models.Model):
switch = models.OneToOneField(
Switch,
on_delete=models.CASCADE, # 注意：Django 5.x 要求显式 on_delete
db_column='switch',
primary_key=True,
related_name='config_state' # ✅ 反向关系名保持不变
)
class Meta:
managed = False
db_table = 'ConfigState'
# ✅ 删除 app_label
class EdgeSwitch(models.Model):
switch = models.OneToOneField(
Switch,
on_delete=models.CASCADE,
db_column='switch',
primary_key=True,
related_name='edge_switch'
)
class Meta:
managed = False
db_table = 'EdgeSwitch'
# ✅ 删除 app_label? 同时，请确保：
- 模型文件位于某个已注册的应用目录下（例如
myapp/models.py）； -
settings.py中包含该应用：INSTALLED_APPS = [..., 'myapp', ...]； - Django 5.x 强制要求
OneToOneField和ForeignKey必须指定on_delete参数（如models.CASCADE），否则启动时报错。
? 补充说明：若你确实需要跨应用引用（例如 ConfigState 定义在 myapp_models 应用中），则必须：
- 创建真实的应用目录
myapp_models/（含apps.py,models.py,__init__.py）； - 在
settings.py中添加'myapp_models'到INSTALLED_APPS； - 确保
myapp_models.apps.MyAppModelsConfig.default_auto_field已正确定义（Django 5.x 推荐）。
总结：Django 5.x 提升了模型注册的健壮性与安全性，手动 app_label 是“高级用法”，仅在多数据库、遗留表映射或插件化架构中有必要；绝大多数场景下，删掉 app_label 即可恢复兼容的反向查找能力，并符合 Django 最佳实践。
