Nominatim数据导入性能优化指南

问题背景

在使用Nominatim导入OSM数据时，用户遇到了导入过程异常缓慢甚至卡死的问题。具体表现为：

1. 导入亚洲数据后无法继续导入欧洲数据
2. 尝试单独导入欧洲数据时进程卡死
3. 添加国家级别数据时同样出现进程挂起
4. 最终成功导入了完整星球数据，但原因不明

硬件配置分析

用户硬件配置为：

• CPU：AMD Ryzen 7 5700G（8核16线程）
• 内存：32GB
• 存储：2TB SSD + 128GB系统盘

理论上，这样的配置应该能够处理大洲级别的数据导入，但需要特别注意内存管理和PostgreSQL参数调优。

常见问题原因

1. 内存不足：Nominatim和PostgreSQL在导入过程中会消耗大量内存，32GB对于完整星球数据导入可能不足。

2. PostgreSQL参数未优化：默认配置通常针对高内存机器（如128GB），在小内存机器上会导致操作系统频繁交换内存到磁盘。

3. 缺少Flatnode文件：导入大洲或星球数据时未使用flatnode文件，导致性能下降。

4. 进程状态D（不可中断睡眠）：通常表示进程正在等待I/O操作完成，可能是磁盘性能瓶颈或内存交换导致。

优化建议

1. 使用Flatnode文件

对于大洲或星球级别的数据导入，必须启用flatnode文件：

nominatim import --osm-file europe-latest.osm.pbf --flat-nodes /path/to/flatnode.file

2. PostgreSQL参数调优

根据32GB内存调整postgresql.conf关键参数：

shared_buffers = 8GB
work_mem = 256MB
maintenance_work_mem = 4GB
effective_cache_size = 16GB

3. 分阶段导入策略

对于32GB内存机器，建议：

1. 先导入小区域数据测试
2. 确认系统稳定后再导入大洲数据
3. 避免连续导入多个大文件

4. 监控资源使用

导入过程中监控：

• 使用htop查看CPU和内存使用
• 使用iotop检查磁盘I/O
• 检查PostgreSQL日志是否有错误或警告

5. 磁盘优化

确保：

• Nominatim数据库和flatnode文件放在快速SSD上
• 有足够的磁盘空间（星球数据需要约1TB）
• 文件系统预留足够inode

故障排查步骤

1. 检查PostgreSQL日志：查找OOM（内存不足）或配置错误信息

2. 监控系统资源：

   free -h  # 内存使用
   vmstat 1 # 系统整体状态
   iostat -x 1 # 磁盘I/O
   

3. 验证Flatnode文件：确保有足够权限和空间

4. 测试小数据集：先用小区域数据验证配置

最佳实践

1. 对于32GB内存机器，建议优先导入特定国家或区域而非整个大洲

2. 考虑使用Nominatim的Docker镜像，它包含预优化的配置

3. 定期维护数据库：

   nominatim refresh --website
   

4. 考虑使用更强大的机器进行初始导入，然后迁移到生产环境

通过以上优化措施，可以在32GB内存的机器上稳定导入大洲级别的OSM数据，避免进程卡死和性能问题。