Shapefile 转 GeoJSON失败或结果异常？排错指南
排查Shapefile 转 GeoJSON的扩展名、文件结构、依赖、编码、内存和结果误差，同时保留原文件。
先保留原文件
不要改后缀后覆盖源文件，也不要把网页预览当成唯一验收记录。复制一份小样本并记录文件大小、来源软件、版本、浏览器和完整错误提示。
这个格式最容易忽略的事实
例如一个行政区 ZIP 中有 region.shp、region.shx、region.dbf 和 region.prj。转换前先确认四个文件同名；转换后抽查中文名称、要素数和边界是否落在预期地区。
推荐排查顺序
- 使用页面示例或较小的已知正常文件，确认工具本身能够运行。
- 检查扩展名、文件签名、配套文件、远程 URL 和 CORS，排除下载到 HTML 错误页。
- 对照操作步骤重新提供输入：
- 选择包含同名 .shp、.dbf、.shx 和可选 .prj 的 ZIP。
- 确认检测到的图层、要素数、几何类型和字段编码。
- 预览边界与少量属性，检查坐标是否合理。
- 下载 UTF-8 GeoJSON，并保留原始 ZIP 用于追溯。
- 关闭占内存的标签页并使用最新版 Chrome 或 Edge 重试。
- 仍异常时回到生成文件的专业软件重新导出，在目标系统复核。
常见问题与答案
为什么要上传 ZIP？
SHP 几何和 DBF 属性分开存储，ZIP 能避免漏选配套文件。
坐标为什么不在地图上？
常见原因是缺少 PRJ 或源坐标系声明错误；请在 GIS 软件中确认 CRS。
文件会上服务器吗？
文件在当前浏览器标签页中处理，不会为了运行该功能上传到 FreeTool 服务器。
不应绕过的限制
- 缺少或错误 PRJ 时无法可靠转换到 WGS84
- DBF 编码不明确可能造成中文乱码
- 不处理复杂地理数据库、空间索引或拓扑修复
隐私处理
本地输入不会为了处理上传到 FreeTool；远程 IIIF/DZI URL 会由浏览器访问来源服务器。排错截图、OCR 文本、模型摘要和转换文件可能包含敏感或受版权保护内容，分享前应脱敏并确认权限。