Django中两张表无法通过Admin或API读取，PostgreSQL可正常访问求助

1. 模型字段/表名使用PostgreSQL保留字且未转义 #

PostgreSQL有一系列保留关键字（如user、order、default、class等），如果Django模型的字段名或db_table直接使用这些保留字，Django生成SQL查询时会因语法错误触发格式字符串异常。

• 解决方案：
  • 给字段添加db_column参数，用双引号包裹字段名：

    # 示例：字段名为class（保留字）
    class_name = models.CharField(max_length=100, db_column='"class"')
    

  • 若为表名问题，在模型Meta类中给db_table加双引号：

    class Meta:
        db_table = '"order"'  # 表名为order（保留字）
    

  • 长期方案：重命名字段或表名，避免使用保留字。

2. 模型字段的default参数包含未正确处理的格式化占位符 #

如果模型字段的default值是带%s、%d这类占位符的字符串，Django会将其视为需要格式化的字符串，但未传入对应参数，直接触发TypeError。

• 解决方案：
  • 将带占位符的默认值改为静态字符串，若需动态默认值，使用可调用对象：

    # 错误写法
    # description = models.TextField(default="Item %s")
    # 正确写法（静态值）
    description = models.TextField(default="Default Item")
    # 或动态值（用lambda）
    description = models.TextField(default=lambda: f"Item {uuid.uuid4().hex[:8]}")
    

3. 自定义管理器/查询集存在字符串格式化错误 #

如果这两张表的模型使用了自定义Manager或QuerySet，其中的代码可能存在%格式化字符串时参数数量不匹配的问题，导致生成查询时报错。

• 解决方案：
  • 检查自定义管理器和查询集的代码，定位所有使用字符串格式化的地方，确保占位符数量与传入参数一致；推荐改用f-string或str.format()替代旧式%格式化，减少错误：

    # 错误写法
    # query = "SELECT * FROM table WHERE id = %s"  # 未传入参数
    # 正确写法
    query = f"SELECT * FROM table WHERE id = {self.id}"
    

4. 模型字段与数据库表字段类型不匹配 #

若Django模型定义的字段类型与PostgreSQL表实际字段类型不兼容（比如模型用TextField对应数据库的jsonb字段），会导致Django生成查询时出现解析错误，间接触发格式字符串异常。

• 解决方案：
  • 通过pgAdmin查看异常表的字段类型，逐一核对Django模型字段定义，确保类型匹配：

    # 数据库是jsonb字段，模型对应写法
    data = models.JSONField(default=dict)
    # 数据库是timestamp字段，模型对应写法
    created_at = models.DateTimeField(auto_now_add=True)
    

5. 模型的Meta类db_table定义格式错误 #

如果db_table包含特殊字符（如空格、连字符）且未正确引用，Django生成的SQL会出现语法问题，导致格式字符串错误。

• 解决方案：
  • 给包含特殊字符的表名加双引号：

    class Meta:
        db_table = '"mix designs"'  # 表名含空格
    

  • 或修改数据库表名，使用下划线替代特殊字符，简化模型定义。

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