ArcPy Near_analysis类内运行返回-1、类外正常问题求助

• 空间参考一致性校验
  这是触发近邻匹配结果为0的最高发原因。类内生成要素类时如果没有显式传入空间参考参数，会生成无坐标定义的要素类，哪怕坐标数值完全正确，近邻分析引擎会因两个数据集空间参考不匹配、范围无交集，直接判定无有效邻接要素。
  排查操作：执行近邻分析前，分别打印两个输入要素类的空间参考信息，执行语句为print(arcpy.Describe(待测要素类).spatialReference.exportToString())，确认两个数据集的空间参考完全一致，不要依赖引擎的自动投影适配逻辑。
• 要素类路径与有效性校验
  类内动态生成要素类时，如果存储路径和当前激活工作空间不匹配，或者存在路径大小写、特殊字符的格式问题，会导致近邻分析调用时无法正确读取已生成的要素。如果使用in_memory存储临时要素，要确认类内作用域没有提前切换、清空in_memory工作空间。
  排查操作：执行近邻分析前，用arcpy.Exists(要素类完整路径)、int(arcpy.GetCount_management(要素类完整路径).getOutput(0))两个语句，逐一对两个输入要素做存在性、非空校验，确认读到的要素数量和预期生成数量一致，再传入近邻分析工具。
• 资源清理时序校验
  类内运行时如果触发提前清理逻辑——比如类的析构方法、成员方法在近邻分析执行前，就调用了arcpy.Delete_management、arcpy.ClearWorkspaceCache_management之类的清理操作，会导致近邻分析拿到已经被删除的空路径引用，最终识别到的输入要素数量为0。
  排查操作：把所有资源清理逻辑移动到近邻分析执行完成、结果读取完成之后，再运行测试，确认问题是否消失。
• 近邻分析参数合理性校验
  类内调用工具时如果没有显式传参，可能触发不合理的默认参数值，比如设置了远小于实际坐标分布范围的搜索半径，导致引擎在指定搜索范围内找不到任何邻接要素，最终输出结果填充为-1。
  排查操作：第一次测试时将近邻分析的搜索半径参数设为空（即不限制搜索范围），确认能正常匹配结果后，再根据业务需求调整搜索半径数值。

内容的提问来源于stack exchange，提问作者Affifa Taskeen