如何解决psycopg2连接PostgreSQL时报relation 'estates'不存在错误

你遇到的情况是本地Mac环境运行正常，但Debian VPS的Docker PostgreSQL提示estates表不存在，且已尝试指定schema、添加引号仍无效，按以下方向逐一排查：

• 确认API连接的数据库是否正确
  检查DatabaseManager.get_connection()中的数据库名称参数，是否和本地一致？远程Docker容器内可能创建了多个数据库，你导入SQL时可能误导入到其他库，而API连接的是另一个空库。
  进入远程PostgreSQL容器手动验证：

  docker exec -it <postgres容器名> psql -U <数据库用户名> -d <API连接的数据库名>
  

  执行\dt查看当前数据库的表列表，确认estates是否存在。

• 检查PostgreSQL的搜索路径（search_path）
  PostgreSQL会根据search_path查找默认schema，本地环境可能默认包含public，但远程环境的搜索路径可能被修改。在API连接的数据库中执行：

  SHOW search_path;
  

  如果结果里没有public，可临时设置生效：

  SET search_path TO public;
  

  或者永久修改（需重启数据库）：

  ALTER ROLE <API使用的数据库用户名> SET search_path TO public;
  

• 核对表名的大小写与实际存在性
  PostgreSQL默认会将未加引号的表名转为小写，但如果本地建表时使用了引号（比如CREATE TABLE "Estates"），表名会区分大小写。远程导入后，执行以下SQL确认表名：

  SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';
  

  如果表名是Estates（首字母大写），查询时必须带引号：SELECT * FROM "Estates" WHERE id_estate = %s

• 验证数据库用户权限
  确认API使用的数据库用户拥有public schema的访问权限和estates表的查询权限：

  GRANT USAGE ON SCHEMA public TO <API使用的数据库用户名>;
  GRANT SELECT ON estates TO <API使用的数据库用户名>;
  

  执行后重新启动API服务测试。

• 检查SQL导入的完整性
  重新核对本地导出的SQL文件，确认包含CREATE TABLE estates语句；再检查远程导入过程是否有报错日志。若导入不完整，重新执行一次SQL导入操作。

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