先确认失败发生在哪一步
区分连接前失败与连接后的操作错误。
阅读提示并展开可用的服务器错误详情，记录错误代码、数据库／模式和表。
UI 编号是应用提示编号，不是数据库错误编号。
不要立即重复操作，请先按下列症状检查。
超时、连接被拒绝或找不到主机
将主机名和端口与服务信息核对，检查服务器、网络及所需 VPN。
请管理员检查防火墙和来源 IP 限制。
SSH 连接应分别检查电脑到 SSH、SSH 到数据库两段。
作为数据库目标，127.0.0.1 在直接连接中指本机，在隧道中指 SSH 服务器。
用户名、密码或私钥错误
区分数据库与 SSH 的认证信息。
SSH 登录成功不代表数据库认证成功。
选择私钥本身而不是 .pub 文件，并使用对应的 Windows、WSL 或手动路径。
私钥口令与 SSH 登录密码不同。
找不到数据库时核对准确名称；PostgreSQL 需要数据库名而不是模式名。
检查 CA、主机名和 SSH 主机密钥
选择服务提供的 CA 本地文件，而不是下载 URL。
证书错误应检查正式主机名、有效期、电脑时间和 CA。
首次 SSH 主机密钥应与管理员提供的指纹核对。
已知密钥或证书改变时先确认原因，不要仅为消除警告而关闭验证或删除已保存密钥。
已连接但看不到表或操作被拒绝
重新选择目标数据库／模式并刷新。
认证和操作权限不同：读取、搜索、导出需要 SELECT，修改需要 UPDATE，新增需要 INSERT，删除需要 DELETE；结构修改可能需要 ALTER。
请管理员确认具体目标与操作所需权限，无需默认授予全部管理员权限。
无法编辑单元格或保存失败
没有主键时可能无法安全识别行；包含 JOIN 或聚合的 SQL 结果也可能只读。
生成列、二进制和截断显示的值有编辑限制。
保存失败应检查格式、长度、NOT NULL、主键或 UNIQUE 重复、外键以及 UPDATE 权限。
添加主键属于结构修改，应先检查数据与设计。
重试前确认当前状态
更新或删除时断线不代表没有执行。
重新连接并刷新目标，多行删除可能已部分完成。
搜索无结果时检查条件、AND／OR 和值类型。
导出失败时检查 SELECT、磁盘空间和写入权限。
仍无法解决时，提供应用版本、系统、数据库产品、连接方式、步骤及错误详情，并去除密码、私钥和个人信息。