自托管OpenRouteService（Python）地理编码报错求助

路线查询正常说明ORS核心服务和地图数据加载无问题，地理编码失败的核心原因集中在Pelias服务未正确部署、配置或数据未导入，按以下步骤逐一排查：

1. 确认Docker部署是否包含Pelias组件 #

检查你的docker-compose.yml文件：

• 查看是否存在pelias-api、pelias-elasticsearch、pelias-importer这类服务节点
• 若没有，说明当前ORS部署未集成Pelias，需修改docker-compose配置添加完整的Pelias服务栈

2. 修正地图数据放置路径 #

你下载的比利时.osm.pbf地图文件，不能放在ORS的docker/data目录，需要放到Pelias指定的数据目录：

• 找到docker-compose中Pelias服务的卷挂载配置（例如./pelias/data:/data）
• 将.osm.pbf文件复制到本地对应的./pelias/data目录，确保容器能读取该文件

3. 验证Pelias服务状态 #

执行docker ps查看容器状态：

• 确认所有Pelias相关容器（尤其是pelias-api、pelias-elasticsearch）处于Up状态
• 若容器未启动，查看日志定位问题：docker logs <pelias-container-name>（常见原因：内存不足、数据目录权限错误）

4. 确保Pelias完成数据导入 #

Pelias需要将.osm.pbf数据导入Elasticsearch才能提供地理编码服务：

• 查看pelias-importer容器日志，确认数据导入无报错且已完成
• 若未执行导入，运行导入命令：

  docker-compose run pelias-importer import
  

5. 检查ORS配置中的Pelias地址 #

打开ORS的app.config配置文件（通常在docker/conf目录）：

• 找到services.geocoding.providers.pelias.url项，确认地址为Pelias-api容器的正确内部地址，例如http://pelias-api:4000/v1
• 地址错误会直接导致404请求失败

6. 直接测试Pelias接口 #

绕过ORS，直接向Pelias-api发送请求验证服务可用性：

curl "http://localhost:4000/v1/search?text=Brussels"

• 若返回正常JSON，说明Pelias服务正常，问题出在ORS的调用逻辑或配置
• 若仍返回404/解码错误，回到步骤2-4排查Pelias自身问题

额外提示 #

• Pelias对内存要求较高，建议给Docker分配至少8GB内存，否则Elasticsearch可能启动失败
• 调整地图文件权限：chmod 644 <your-belgium-osm-file.osm.pbf>，确保容器用户可读取

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