验证安装与连接

安装或配置完成后，应验证完整使用链路，而不只是确认页面能够打开。推荐按照“服务—认证—权限—上下文—任务”的顺序检查，这样更容易定位问题所在。

​

目标

使用分层检查方法验证 PawSQL 服务、认证、权限、工作空间和 SQL 分析链路。

​

准备工作

已部署 PawSQL 服务（Cloud 或 Server），并准备好非生产工作空间和脱敏只读测试 SQL。

​

操作步骤

按「服务—认证—权限—上下文—任务」的顺序逐项验证整条链路。

​

验证范围

​

1. 验证服务访问

• 使用预期的域名或服务地址打开 PawSQL。
• HTTPS 证书可信，域名与证书匹配。
• 页面能够正常加载，没有代理、跨域或网关错误。
• IDE 或 MCP 所在设备能够访问同一服务地址。
• PawSQL Server 管理员确认核心服务运行正常。

如果 Web 可以访问而 IDE 或 MCP 无法访问，应重点检查客户端代理、证书信任和网络区域差异。

​

2. 验证身份认证

• Web 用户可以正常登录。
• 登录后显示的账号与预期一致。
• IDE、MCP 或 API 使用的访问凭据仍在有效期内。
• 认证失败时不会在日志中输出完整密码或令牌。

​

3. 验证权限

• 可以进入正确的组织或项目。
• 能够看到角色需要的菜单。
• 能够查看或创建测试工作空间。
• 能够创建 SQL 优化测试任务。
• 普通用户无法访问不属于其职责的管理功能。

​

4. 验证工作空间

选择已有测试工作空间，或创建一个最小工作空间：

• 数据库类型和版本正确。
• DDL 导入成功，或数据库连接测试成功。
• 可以查看测试 SQL 涉及的表和列。
• 需要智能索引推荐时，工作空间包含必要的索引信息。
• 当前用户具有使用该工作空间的权限。

如果数据库连接失败，应从 PawSQL Server 所在网络检查数据库地址、端口、白名单、TLS 和账户权限。

​

5. 验证 SQL 分析

使用一条脱敏且只读的测试查询完成验证。

​

客户端专项验证

​

问题定位表

​

验收记录建议

生产上线或团队推广前，建议保存以下信息：

• PawSQL 产品和版本；
• 部署环境与服务地址；
• 验证日期和负责人；
• 浏览器、IDE 或 MCP 客户端版本；
• 测试账号角色；
• 测试工作空间和数据库类型；
• 测试任务编号；
• 通过项、未通过项和后续负责人。

​

下一步