---
title: 排查问题
description: 组织 AI 低代码开发中的同步冲突、登录失败、远端变化、丢失修改和运行异常排查任务。
navTitle: 排查问题
indexTitle: 概述
---
# 排查问题

排查问题用于处理“推不上去”“登录失败”“远端变化看不到差异”“修改丢了”“数据不对”“页面没反应”“调度没跑”这类阻塞交付的问题。排查前先保护现场，确认服务器、项目、本地变化和 Git 状态。

## 什么时候进入

遇到以下问题时，先阅读本目录：

- 推送、拉取、同步或登录被阻塞。
- 本地变化、远端变化、Git 状态或同步基线看起来不一致。
- 修改疑似丢失、被覆盖，或远端变化显示不出实际内容差异。
- 元数据文件在浏览器预览或设计器中报错，需要先用 CLI 校验本地内容。
- 页面、数据、权限或调度异常，需要先保护现场再定位问题。

## 任务入口

| 问题 | 先读 | 适用情况 |
| --- | --- | --- |
| 冲突处理 | [冲突处理](./conflict-handling.md) | 本地和服务器都修改了同一个资源，推送或拉取前需要判断保留哪一侧。 |
| 自动登录失败 | [自动登录失败](./auto-login-failed.md) | 每次打开工作区都需要重新认证，或服务器不再接受已保存的授权状态。 |
| 远端变化没有内容差异 | [远端变化没有内容差异](./remote-changes-no-diff.md) | SuccApp 显示远端变化，但文件正文看起来没有可见差异。 |
| 找回丢失修改 | [找回丢失修改](./recover-lost-changes.md) | 本地修改疑似被覆盖、被重置或找不到，需要先停止继续同步操作。 |
| 元数据合法性校验 | [元数据合法性校验](./metadata-validation.md) | AI 修改 `.dash`、`.spg`、`.tbl` 等元数据文件后，需要在推送或浏览器预览前检查本地内容是否能通过服务器编译。 |

## 相关阅读

- [修改与同步](../workspace/sync-changes.md)：理解拉取、推送、查看变化和同步基线。
- [Diff 审查](../quality/diff-review.md)：确认差异内容和风险范围。
- [元数据静态检查](../quality/metadata-check.md)：了解推送前的结构、类型、引用和编译检查组合。