故障排查概览

本文汇总 CloudBase PostgreSQL 常见问题的排查路径。遇到问题时，先确认报错发生在连接、权限、SQL 执行、HTTP API、备份恢复还是性能层面。

快速定位

症状	优先查看
不确定问题类型，或遇到 HTTP 401/403/404/409/500 等常见错误	常见错误速查
无法连接数据库、连接超时、密码错误	连接失败
查询返回空数组、提示 permission denied	权限与 RLS 问题
HTTP API 新字段不可见、RPC 找不到函数	Schema Cache 问题
备份失败、恢复后数据不符合预期	备份与恢复问题
查询慢、连接池排队、锁等待	查询优化和日志与监控

提交问题或自查前，建议先收集以下信息：

检查当前连接：

select current_database(), current_user, now();

检查表是否存在：

select table_schema, table_name
from information_schema.tables
where table_schema = 'public'
order by table_name;

检查 RLS 是否启用：

select schemaname, tablename, rowsecurity
from pg_tables
where schemaname = 'public';