故障排查指引

“故障排查指引”用于协助企业管理员在平台运行过程中遇到功能异常、访问异常、数据异常等情况时，进行初步自助排查，明确问题类别，并收集必要信息以便进一步提交给图新技术支持团队。

常见故障类型包括：

• 平台无法访问 / 加载缓慢
• 登录失败 / 无法验证身份
• 数据上传失败 / 无法显示
• 发布服务失败 / 地图服务异常
• 页面报错 / 功能按钮无响应

二、操作步骤

1. 检查本地网络连接状态

1. 尝试访问企业内部其他系统或网站，排除网络故障；
2. 若使用域名访问平台，尝试通过 IP 地址直接访问判断是否为 DNS 问题；
3. 若为内网部署，请联系IT部门确认服务器网络状态是否正常。

2. 登录异常或访问受限

1. 检查浏览器控制台是否报错（快捷键 F12 → Console 面板）；
2. 清除浏览器缓存或尝试使用隐私模式重新登录；
3. 确认账号是否被禁用、所在企业是否已过期；

3. 数据上传 / 发布失败

1. 确认上传文件格式是否符合平台支持标准（如 SHP、TIFF、3D Tiles 等）；
2. 检查上传数据大小是否超出企业套餐限制或服务容量；
3. 在【系统管理 → 日志管理】中查看是否有相关异常日志（如磁盘空间不足、存储配置错误）；
4. 检查目标项目是否存在、权限是否正确配置。

4. 服务加载失败 / 三维场景打不开

1. 检查浏览器是否开启硬件加速；
2. 使用开发者工具查看接口返回码（如 500、403 等）定位问题；
3. 检查场景所依赖的数据是否已被删除或未发布成功；
4. 若使用私有对象存储服务，请确认对象存储访问正常。

5. 系统功能异常 / 页面无响应

1. 记录异常时间和操作步骤，截图页面及控制台报错信息；
2. 切换其他账号或浏览器尝试是否同样异常；
3. 若近期刚升级或更改配置，请回滚最新配置或联系运维核查。

四、建议收集的信息（供提交技术支持）

• 企业名称及服务器部署信息（IP、操作系统、数据库等）；
• 问题发生时间、操作路径、异常截图或视频；
• 浏览器控制台日志（Console）、网络请求（Network）；
• 系统日志文件（可通过【系统管理 → 日志管理】导出）；
• 数据样本或操作文件（如上传失败的数据）；
• 是否出现批量问题，或仅特定用户/数据/模块触发。

五、特殊情况处理建议

如无法解决，请将上述信息整理并提交至技术支持邮箱或通过服务群联系图新技术支持团队，我们将第一时间协助解决。