Heroku环境下安装GDAL（OGR模块）失败的问题排查求助

核心问题分析 #

你遇到的问题本质是系统级GDAL与Python绑定版本不匹配，或Python未识别到系统安装的绑定模块路径。以下提供两种经过验证的解决方案：

方法一：使用heroku-geo-buildpack（推荐） #

该buildpack会自动安装系统级GDAL，并确保Python绑定能匹配版本：

1. 调整Buildpack顺序：确保geo buildpack先于Python buildpack执行（系统依赖需先安装）

   heroku buildpacks:clear
   heroku buildpacks:add https://github.com/heroku/heroku-geo-buildpack.git
   heroku buildpacks:add heroku/python
   

2. 匹配GDAL版本：
   • 部署一次代码，查看日志中GDAL_VERSION字段（例如GDAL_VERSION: 3.7.0）
   • 在requirements.txt中添加完全一致的版本号：

     GDAL==3.7.0
     

   （版本号必须与buildpack安装的系统GDAL完全匹配，否则会出现头文件缺失/版本不兼容的编译错误）
3. 重新部署代码，此时pip会基于系统已安装的GDAL头文件编译对应版本的Python绑定，可正常导入osgeo模块。

方法二：使用Aptfile安装系统级Python绑定 #

直接通过apt安装GDAL及官方Python绑定，避免pip编译冲突：

1. 创建Aptfile：在项目根目录新建Aptfile，写入以下内容：

   gdal-bin
   libgdal-dev
   python3-gdal
   

2. 清理requirements.txt：移除其中的GDAL条目，防止pip重复安装导致冲突。
3. 配置Python路径：让Python识别系统级绑定的安装路径：
   • 方案1：在代码开头添加路径（适合小型项目）：

     import sys
     sys.path.append('/usr/lib/python3/dist-packages')
     from osgeo import ogr
     

   • 方案2：设置Heroku环境变量（全局生效）：

     heroku config:set PYTHONPATH=/usr/lib/python3/dist-packages
     

4. 重新部署代码，即可正常导入ogr模块并使用FlattenTo2D()方法。

额外注意事项 #

• 确认Heroku栈版本（如heroku-20/heroku-22），不同栈的apt包版本不同，python3-gdal对应的GDAL版本也会有差异，FlattenTo2D()方法在GDAL 2.1及以上版本均支持。
• 若使用方法一仍出现编译错误，可尝试用pygdal替代GDAL，在requirements.txt中写入：

  pygdal==$(gdal-config --version)*
  

  该包会自动匹配系统安装的GDAL版本进行安装。

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