Wagtail模型修改及新建模型未在Admin后台显示问题求助

结合你描述的情况——全新安装Wagtail、迁移正常但后台字段缺失、同一VPS跑两个项目共用PostgreSQL，我整理了几个最可能的原因和解决步骤：

1. 页面模型没正确配置后台显示面板 #

这是最常见的原因！Wagtail不会自动把你新增的字段加到后台编辑界面，必须手动在模型里定义content_panels（或者edit_handler）。

比如你修改HomePage加了Body字段，但如果没把Body加到content_panels里，后台就只会显示Page基类默认的Title字段。正确的写法应该是：

from wagtail.models import Page
from wagtail.fields import RichTextField
from wagtail.admin.panels import FieldPanel

class HomePage(Page):
    body = RichTextField(blank=True)

    # 必须把新增字段加到content_panels里
    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

新建的自定义Page模型也是一样，一定要手动配置content_panels，不然默认只会显示Title。

2. 缓存没清理导致界面不更新 #

Wagtail和Django都有界面缓存，尤其是你在同一VPS跑两个项目，缓存冲突或者旧缓存没清的概率很高：

• 先清Django缓存：在项目根目录运行 python manage.py clear_cache
• 强制刷新浏览器（Ctrl+Shift+R），避免浏览器缓存旧的后台界面
• 如果你的项目用了Redis/Memcached这类缓存后端，重启缓存服务或者手动清空缓存

3. 数据库连接配置出错（项目串库了） #

虽然你说PostgreSQL用户是超级用户，但两个项目共用实例，有可能你的当前项目连接的是另一个项目的数据库？

• 打开项目的settings.py，检查DATABASES配置，确认NAME是当前项目的数据库名，USER是对应的PostgreSQL用户
• 可以运行 python manage.py inspectdb，看看输出里有没有你新增的字段；或者直接用psql连接到对应数据库，查询表结构确认字段存在

4. 模型注册或App配置问题 #

• 确认你的app已经加到settings.py的INSTALLED_APPS里，不然Wagtail找不到你的自定义Page模型
• 检查自定义Page模型的继承：必须继承wagtail.models.Page，而不是Django原生的models.Model
• 检查模型代码有没有语法错误，比如字段定义写错了，导致Wagtail无法正确加载模型

5. 迁移执行的是错误的项目 #

同一VPS两个项目，很容易搞混目录和虚拟环境：

• 切换到当前项目的虚拟环境，确认当前工作目录是项目根目录
• 运行 python manage.py showmigrations，看看所有迁移是否都已标记为应用
• 运行 python manage.py migrate --check，确认没有未应用的迁移

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