使用psycopg2连接PostgreSQL时遇'person表不存在'错误的解决方法

以下是几种常见的排查和解决思路：

1. 确认表名拼写与大小写是否正确 #

PostgreSQL对表名的大小写处理严格：如果创建表时用双引号指定了大写名称（比如"Person"），查询时必须用引号包裹，否则会被自动转为小写导致找不到表。

• 可以在psql终端执行\dt命令，查看当前数据库的所有表，确认person表是否存在，以及实际名称的大小写。
• 另外注意：user是PostgreSQL的保留字，直接写FROM user u会触发语法问题，需要改成FROM "user" u或者用sql.Identifier引用。如果表名存在大小写问题，修改代码时用sql.Identifier正确引用：

  query_str = sql.SQL(
       """ 
       SELECT {fields} 
       FROM {user_table} u 
       JOIN {person_table} p ON u.person_id=p.id 
       JOIN employee_contract ec ON ec.person_id=p.id
       WHERE u.username LIKE '%word%'
       """).format(
           fields=flds, 
           user_table=sql.Identifier('user'),
           person_table=sql.Identifier('Person')  # 替换为实际表名
       )
  

2. 验证连接的数据库是否正确 #

你的psycopg2.connect参数可能指向了没有person表的数据库。

• 可以在代码中添加语句确认当前连接的数据库：

  db_cursor.execute("SELECT current_database();")
  print(db_cursor.fetchone())
  

• 确保connect参数中的database字段是包含person表的目标数据库名称。

3. 检查表所在的Schema #

如果person表不在默认的public schema下，需要指定schema路径：

• 方法一：查询时明确指定schema，比如schema_name.person，用sql.Identifier生成正确的标识符：

  person_table = sql.Identifier('your_schema', 'person')
  

• 方法二：在连接时设置默认的search_path，让PostgreSQL能找到对应schema的表：

  db_conn = psycopg2.connect(
      dbname='your_db',
      user='your_user',
      password='your_pwd',
      host='your_host',
      options='-c search_path=your_schema,public'
  )
  

4. 确认数据库用户有访问权限 #

连接数据库的用户可能没有person表的查询权限：

• 可以在psql终端执行以下语句赋予权限（需要超级用户权限）：

  GRANT SELECT ON person TO your_db_user;
  

• 或者在代码中检查当前用户的权限：

  db_cursor.execute("SELECT has_table_privilege(current_user, 'person', 'SELECT');")
  print(db_cursor.fetchone())
  

  如果返回False，说明需要赋予权限。

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