Django测试运行失败：django.db.utils.ProgrammingError: relation "auth_user" does not exist 问题求助

嘿，我太懂这个问题有多闹心了——auth_user是Django自带的核心数据表，连它都找不到，肯定让你折腾得够呛。结合你本地虚拟环境和Docker都出问题的情况，咱们一步步排查这些容易被忽略的点：

• 先确认迁移是否真的执行到位
  别光说“检查过迁移”，咱们用命令实锤：跑一下 python manage.py showmigrations auth，看看auth模块的迁移项是不是都打了勾。如果有没勾的，先单独执行 python manage.py migrate auth，再跑整体的 python manage.py migrate。另外要注意：如果你的测试用了单独的数据库配置（看settings.py里的TEST节点），得确保测试数据库也同步了迁移。

• 检查测试代码是不是“抢跑”了
  很多人会在测试文件的模块级别（比如测试类外面）写初始化代码，比如提前实例化User模型、导入依赖数据库的工具类——这时候Django的测试框架还没来得及创建并迁移测试数据库，自然找不到表。解决办法很简单：把这些需要数据库的初始化代码移到setUp()或者setUpTestData()方法里，等测试环境准备好再执行。

• 自定义User模型的坑要留意
  如果你项目里自定义了用户模型，有没有在settings.py里正确设置AUTH_USER_MODEL = 'your_app.YourUserModel'？而且这个配置必须在第一次执行迁移前就设置好，不然Django会先创建默认的auth_user表，之后再自定义模型就会出现表不匹配的问题。要是你是后来才加的自定义User模型，可能得重置数据库：删除所有app下的迁移文件（除了__init__.py），清空数据库，然后重新生成迁移并执行。

• Docker环境的特殊排查点
  Docker里最常见的问题是数据库容器还没完全启动，就执行了migrate和测试。你可以在启动命令里加个等待数据库就绪的逻辑，比如用wait-for-it.sh脚本，或者在docker-compose里设置容器的依赖顺序（让web容器等db容器启动）。另外，检查一下数据库卷是不是有旧数据残留——试试删除数据库卷，重新构建容器，用全新的数据库环境测试。

• 强制重建测试数据库
  有时候测试数据库会有缓存脏数据，你可以跑测试的时候加上参数强制重建：python manage.py test --noinput --keepdb=False，这个命令会彻底删除旧的测试数据库，重新创建并自动执行迁移，再跑测试。

如果这些方法都试过还是不行，你可以补充点信息：有没有自定义User模型？测试代码的大致结构？Docker-compose的配置片段？这样能更精准帮你定位问题。

内容来源于stack exchange