Django从PostgreSQL拉取数据渲染页面报错：id列不存在

核心原因 #

Django默认会为模型自动生成id自增主键列，但你用Pandas直接写入数据库时，要么没创建这个列，要么表结构和Django模型定义不匹配，导致ORM查询时找不到id列。

修复步骤 #

1. 对齐模型与表结构 #

确保models.py中的模型定义和数据库表名、字段完全匹配，示例：

from django.db import models

class ProcessedDataModel(models.Model):
    # 自定义字段，需和DataFrame列名一致
    content = models.TextField()
    create_time = models.DateTimeField()

    class Meta:
        db_table = 'myapp_processeddatamodel'  # 必须和数据库表名完全一致

注：无需手动定义id字段，Django会自动添加自增主键；如果手动定义，要确保是AutoField(primary_key=True)类型。

2. 修正Pandas写入逻辑 #

推荐方案：先通过Django迁移建表，再追加数据

• 先执行迁移创建符合Django要求的空表：

python manage.py makemigrations
python manage.py migrate

• 然后用Pandas写入时，指定if_exists='append'，禁止Pandas重建表：

import pandas as pd
from sqlalchemy import create_engine
from django.conf import settings

# 从Django配置读取数据库连接信息
db_url = f'postgresql://{settings.DATABASES["default"]["USER"]}:{settings.DATABASES["default"]["PASSWORD"]}@{settings.DATABASES["default"]["HOST"]}:{settings.DATABASES["default"]["PORT"]}/{settings.DATABASES["default"]["NAME"]}'
engine = create_engine(db_url)

# 处理JSON生成DataFrame
df = pd.read_json(request.FILES['json_file'])
# 确保DataFrame列名和模型字段名一致（无需包含id，Django自动生成）
df.to_sql('myapp_processeddatamodel', engine, if_exists='append', index=False)

备选方案：强制Pandas写入时包含id列

如果必须用Pandas创建表，需手动添加自增主键列：

# 给DataFrame添加自增id序列
df['id'] = pd.RangeIndex(start=1, stop=len(df)+1)
# 写入时指定id为自增主键
df.to_sql('myapp_processeddatamodel', engine, if_exists='replace', index=False, dtype={
    'id': 'SERIAL PRIMARY KEY'
})

此方案需确保数据类型完全符合Django要求，否则后续ORM操作可能出错。

3. 验证数据库表结构 #

登录PostgreSQL执行以下命令，确认id列存在且为自增主键：

\d myapp_processeddatamodel

正常输出应包含：

id | integer | not null default nextval('myapp_processeddatamodel_id_seq'::regclass)

且该行标注PRIMARY KEY。

4. 修正视图查询逻辑 #

确保视图使用Django ORM查询，避免原生SQL遗漏id列：

from django.shortcuts import render
from .models import ProcessedDataModel

def upload_page(request):
    # 处理上传逻辑...
    # 用ORM查询全部数据
    processed_data = ProcessedDataModel.objects.all()
    return render(request, 'upload.html', {'data': processed_data})

排查要点 #

• 确认settings.py的DATABASES配置指向的是正确的数据库实例。
• 检查django_migrations表，确认对应模型的迁移记录已执行。
• 若之前手动修改过表结构，可执行python manage.py migrate --fake-initial重置迁移状态（操作前备份数据）。

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