在Heroku上运行带PostGIS的GeoDjango应用遇AttributeError问题

这个错误我之前帮好几个开发者排查过，核心问题几乎都是GeoDjango依赖的PostGIS数据库环境没配置到位，下面一步步帮你解决：

1. 先给Heroku数据库启用PostGIS扩展 #

Heroku默认的PostgreSQL实例不带PostGIS，必须手动开启：

• 先确认你的Heroku Postgres是Standard/Premium计划（部分地区的Hobby计划也支持，但如果报错权限问题，就升级到Standard）
• 用Heroku CLI执行命令开启扩展：

  heroku pg:psql -c "CREATE EXTENSION postgis;"
  

2. 修正settings.py里的数据库引擎配置 #

别用普通的PostgreSQL后端，必须指定GeoDjango的PostGIS专属引擎：

DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',  # 这里是关键！
        'NAME': os.environ.get('DB_NAME'),
        'USER': os.environ.get('DB_USER'),
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': os.environ.get('DB_HOST'),
        'PORT': os.environ.get('DB_PORT'),
    }
}

如果用dj-database-url解析Heroku的DATABASE_URL，要记得指定引擎：

import dj_database_url

DATABASES = {
    'default': dj_database_url.config(conn_max_age=600, engine='django.contrib.gis.db.backends.postgis')
}

3. 确保依赖和INSTALLED_APPS配置正确 #

• requirements.txt里要包含这些：

  Django>=2.2,<3.3  # 适配你用的Python3.6，更高版本Django不再支持3.6
  psycopg2-binary>=2.8
  

• 把django.contrib.gis加到INSTALLED_APPS：

  INSTALLED_APPS = [
      # 你的其他应用...
      'django.contrib.gis',
  ]
  

4. 添加GeoDjango专用的Heroku Buildpack #

GeoDjango需要GEOS、PROJ、GDAL这些系统级地理库，Heroku默认没有，得加专门的buildpack：

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

注意顺序！ geo-buildpack必须在python buildpack前面，这样才能先安装系统依赖。

5. 重新部署并执行迁移 #

做完上面的配置后，重新部署：

git add .
git commit -m "Fix GeoDjango PostGIS config"
git push heroku main

然后运行数据库迁移：

heroku run python manage.py migrate

如果还是有问题，去看Heroku的详细日志（heroku logs --tail），确认数据库连接是否正常、PostGIS是否真的安装成功。

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