Skip to content

表未找到:关系不存在

快速摘要

你的 SQL 引用了不存在的表名 —— 数据库报告未知表或关系错误。

为什么发生

  • 表名拼写错误或在大小写敏感的数据库中使用了错误的大小写

  • 表被删除或尚未由待处理的迁移创建

  • 表在不同的模式中,需要模式前缀(schema.table)

最小示例

✗ 错误代码
await db.query('SELECT * FROM user_orders');
// Error: relation user_orders does not exist — table is user_order
✓ 修复代码
await db.query('SELECT * FROM user_order');
// Or with schema: SELECT * FROM public.user_order;

将表名更正为与实际模式匹配可解决未知表错误。

如何诊断

  • 用 SHOW TABLES 或查询 information_schema 列出表以验证表是否存在

  • 检查表名拼写和当前模式搜索路径

  • 验证所有迁移已运行且表已创建

如何修复

  • 纠正表名拼写或添加模式前缀:myschema.mytable

  • 运行创建表的待处理迁移

  • 设置 search_path 或使用完全限定名引用其他模式中的表

如何预防

  • 使用模式管理工具或迁移系统跟踪表创建

  • 在部署前的集成测试中根据模式验证表名

相关资源

相关术语

相关课程

← 返回语言