ArcPy 修复几何怎么做：CheckGeometry、RepairGeometry 与批处理验收
问题场景
面叠加突然报错、缓冲区出现细碎缝隙、入库后面积统计跳变，很多团队第一反应是重投影或重跑工具，真正的问题却可能是无效几何。ArcPy 的 CheckGeometry 和 RepairGeometry 能把检查与修复放进自动流程，但修复不是“按一下就安全”：不同问题会删除空几何、改变环方向或拆分对象。正确做法是先建立可回退的批次，再用可量化证据证明修复没有损害业务结果。
先区分几何错误与拓扑规则冲突
自相交、空几何和重复顶点属于几何健康度问题；地块重叠、道路悬挂则是数据模型约束。RepairGeometry 不能替代拓扑验证，也不应拿来“修复”业务上不合理的重叠。先明确每个数据集的验收规则，才能决定问题由何处处理。
检查报告是修复范围的依据
CheckGeometry 的输出表要与对象 ID、问题类型和运行批次一起保存。不要只看返回是否成功；同一要素可能被报告多次。抽样定位到地图上，判断问题来自坐标精度、编辑过程还是格式转换，避免把系统性问题用修复掩盖。
修复会改变记录数和面积语义
RepairGeometry 可能删除空要素，也可能使几何类型或面积发生细小调整。对带有外键、附件或审批编号的数据，删除前必须和业务主表对账。面积变化超过容差时应进入人工复核队列，而不是直接覆盖生产库。
批处理必须保留输入输出映射
批处理脚本要输出源路径、目标路径、检查数、修复数和异常数。把原始数据只读保存，修复结果写入新要素类；任何可重跑流程都不该依赖覆盖式修改。
实操流程
- 复制待处理要素类到带日期的工作库，冻结原始输入。
- 运行 CheckGeometry，将报告表按问题类型汇总并导出抽样清单。
- 对可接受的问题在副本上运行 RepairGeometry，记录使用的 OGC 或 ESRI 验证方式。
- 比较修复前后记录数、空几何数、总面积、总长度和关键字段空值。
- 对变化超阈值的对象输出 ID 清单，人工确认后才替换下游输入。
抽样复核与交接
在把“ArcPy 修复几何怎么做：CheckGeometry、RepairGeometry 与批处理验收”写进日常生产流程前，先为本次数据建立一份可回放的运行记录。记录不应只写“处理成功”，而要包含输入数据的来源、获取时间、空间范围、记录数、坐标参考、字段版本和操作者。若输入来自多个部门，还应标明哪一份被视为权威来源，以及发生不一致时由谁确认。
抽样不能只挑地图上看起来正常的区域。至少覆盖范围边缘、属性缺失、历史批次、新增对象和高密度区域；每类样本都要能追溯到稳定 ID。对连续数值，可同时比较最小值、最大值、中位数和异常分位数；对分类结果，则比较类别数量、空值率与前后批次的变化。这样能比单纯浏览地图更早发现口径漂移。
建议把复核结果分成通过、需解释和需返工三类。通过项给出抽样依据与证据位置；需解释项保留业务确认记录；需返工项写清触发规则、影响范围和重跑条件。不要为了让报表整齐而把例外值直接删掉，例外本身往往揭示数据采集、编码或模型边界中的真实问题。
对于会反复运行的任务，应固定参数快照。软件版本、脚本提交号、数据库查询文本、环境变量和关键容差都应随成果留存。特别是日期范围、空间过滤和坐标转换参数，最容易在下一次执行时被默认值替换。参数可复现，才能解释两个批次的结果差异究竟来自数据变化还是流程变化。
交接材料最好同时提供机器可读和人可读两种形式：机器可读的 CSV、日志或 SQL 便于复跑，人可读的说明表帮助审阅者理解字段、单位和质量阈值。将成果链接、源数据定位和异常清单放入同一交付目录；只交付最终地图或截图，会让后续人员失去判断结论可靠性的依据。
发布或入库后再做一次独立抽检。由未参与配置的人按说明重做少量样本，对照对象数量、关键属性、空间位置和统计结果。若独立复现无法得到相同结论，应优先补足说明或修正流程，而不是用口头解释代替证据。这个小成本步骤能有效发现隐藏的本地路径、缓存和权限依赖。
最后，为成果设定复查触发器：数据源更新、字段字典变化、软件升级、行政边界调整或业务口径变更时，必须重新检查本流程的关键假设。把触发器写入项目任务单，能避免旧脚本在新数据上静默运行。GIS 成果真正可信，不是因为某次运行没有报错，而是因为每次变化都能被发现、解释和复验。
项目避坑与质量检查
关键检查点：几何修复后的第一道质量门不是看工具消息，而是做空间回归：把修复前后叠加，筛选对称差和面积差超过容差的对象。对于行政区等边界数据，还要核对相邻面是否引入缝隙。把容差写进脚本参数，避免不同人员凭感觉判断。
FAQ
RepairGeometry 能解决面重叠吗？
不能，它处理几何有效性；面重叠应按拓扑规则和业务边界处理。
可以直接覆盖原数据吗？
不建议。应输出到新数据集并保留可回退的原始批次。
为什么修复后要比较面积？
部分修复会重建几何，面积微调可能影响统计或审批口径。
总结
把修复看作受控变更，而非清理按钮。报告、备份、回归比较和人工例外处理齐全，ArcPy 批处理才真正可审计。