M1 Mac上Docker化GeoDjango+PostGIS项目libgdal.dylib缺失报错求解

• GDAL路径配置错误：settings.py中硬编码的GDAL_LIBRARY_PATH是Mac本地Homebrew的GDAL文件路径，Docker容器运行时使用独立的Linux文件系统，不存在该路径，直接触发找不到共享库的报错。Docker部署场景下所有依赖均封装在容器内部，完全不需要依赖本地环境的GDAL。
• Dockerfile配置不完善：当前Dockerfile未先执行apt update更新包索引就直接安装gdal-bin，大概率会安装失败；且仅安装gdal-bin无法满足GeoDjango的运行要求，还缺少libgdal-dev、libproj-dev等必要依赖。
• 数据库配置不匹配：settings.py中配置的数据库名称、用户名、密码均为postgis，但docker-compose.yaml中db服务的环境变量配置的对应值为postgres，web容器启动后无法匹配到正确的数据库，会触发后续数据库崩溃、无响应的问题。

1. 修正settings.py配置 #

删除硬编码的本地GDAL路径配置，同时对齐数据库配置与docker-compose的设置：

DATABASES = {
    'default': {
        'ENGINE': 'django.contrib.gis.db.backends.postgis',
        'NAME': 'postgres',
        'USER': 'postgres',
        'PASSWORD': 'postgres',
        'HOST': 'db',
        'PORT': 5432,
    }
}
# 删除下方这行本地GDAL路径配置即可，Linux容器内GDAL会自动识别路径，如需手动指定可改为 /usr/lib/libgdal.so
# GDAL_LIBRARY_PATH = '/opt/homebrew/Cellar/gdal/3.2.2_3/lib/libgdal.dylib'

如果要保留settings中postgis的数据库配置，只需同步修改docker-compose中db服务的环境变量即可，二选一即可。

2. 修正Dockerfile配置 #

更新包索引，安装完整的GeoDjango系统依赖：

FROM python:3
ENV PYTHONUNBUFFERED=1
WORKDIR /code
# 安装系统依赖
RUN apt-get update && apt-get install -y \
    binutils \
    gdal-bin \
    libgdal-dev \
    libproj-dev \
    && rm -rf /var/lib/apt/lists/*
# 配置GDAL环境变量，方便Python GDAL包安装时识别依赖
ENV CPLUS_INCLUDE_PATH=/usr/include/gdal
ENV C_INCLUDE_PATH=/usr/include/gdal
COPY requirements.txt /code/
RUN pip install -r requirements.txt
COPY . /code/

3. M1芯片兼容配置（可选） #

如果postgis镜像启动存在架构兼容问题，可在docker-compose的db服务配置中添加一行platform: linux/amd64，通过Rosetta转译运行amd64架构镜像。

执行以下命令清理旧容器并重新启动即可：

docker compose down -v # 清理旧容器和数据卷，避免残留旧数据影响
docker compose build # 重新构建web镜像
docker compose up # 启动服务

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