Docker环境下Jupyter Notebook中GDAL SetConfigOption失效问题

问题背景 #

使用jupyter/minimal-notebook镜像搭建的Docker环境中，GDAL基础功能正常，但通过gdal.SetConfigOption()设置的配置（如WRITE_GFS、VALIDATE等）实际不生效——调用gdal.GetConfigOption()能看到配置值已设置，但对应功能无变化；而Windows本地Jupyter环境中该代码运行完全正常。

可能的解决方案 #

1. 调整配置设置与驱动加载顺序 #

部分GDAL驱动（如GMLAS）可能在配置设置前已完成加载，导致配置无法生效。需确保先设置所有配置选项，再重新加载目标驱动：

from osgeo import gdal, ogr
import os

# 先初始化异常处理并设置所有配置选项
gdal.UseExceptions()
gdal.SetConfigOption("CPL_LOG_ERRORS","ON")
gdal.SetConfigOption("VALIDATE", "YES")
gdal.SetConfigOption("FAIL_IF_VALIDATION_ERROR","YES")
gdal.SetConfigOption('WRITE_GFS','NO')

# 卸载并重新加载GMLAS驱动，使新配置生效
gdal.DeregisterDriverByName("GMLAS")
gdal.RegisterDriverByName("GMLAS")

print(gdal.GetConfigOption("WRITE_GFS"))

driverName="GMLAS"
gml_driver = ogr.GetDriverByName(driverName)

if gml_driver is None:
    raise Exception(f'GDAL driver >{driverName}< not available')
else: 
    print(f"GDAL driver successfully loaded: >{gml_driver.GetName()}<")

gdal.VectorTranslate(
    'test.geojson',
    'Simple_XtraServerGetFeature (3).xml',
    options='-f "GeoJSON"'
)
print(gdal.GetConfigOption("WRITE_GFS"))

2. 通过Docker环境变量设置GDAL配置 #

GDAL会优先读取系统环境变量中的配置，可能容器默认环境变量覆盖了代码设置。可在Dockerfile中直接添加GDAL相关环境变量：

# Use the jupyter/minimal-notebook image as the parent image
FROM jupyter/minimal-notebook:latest

# 添加GDAL全局环境变量配置
ENV GDAL_WRITE_GFS NO
ENV GDAL_VALIDATE YES
ENV GDAL_FAIL_IF_VALIDATION_ERROR YES
ENV CPL_LOG_ERRORS ON

# Install required dependencies
RUN conda install -c conda-forge gdal
RUN pip install --no-cache-dir \
    jupyter \
    requests>=2.21.0
# Set the working directory to /src
WORKDIR /src

# Make port 8888 available to the world outside this container
EXPOSE 8888

# Define environment variable
ENV NAME World

# Mount the host machine directory into the container
VOLUME /src

# Run Jupyter Notebook when the container launches
CMD ["jupyter", "notebook", "--ip=0.0.0.0", "--port=8888", "--no-browser", "--allow-root"]

3. 统一GDAL版本 #

Docker中安装的GDAL版本可能与本地Windows版本不一致，部分配置选项的行为存在差异。可指定与本地一致的版本安装：

# 替换为你本地使用的GDAL具体版本号
RUN conda install -c conda-forge gdal=3.6.4

4. 直接在VectorTranslate中传递配置 #

GDAL 3.1+版本支持通过config_options参数将配置直接传入VectorTranslate，确保配置针对当前转换任务生效：

gdal.VectorTranslate(
    'test.geojson',
    'Simple_XtraServerGetFeature (3).xml',
    options='-f "GeoJSON"',
    config_options={
        'WRITE_GFS': 'NO',
        'VALIDATE': 'YES',
        'FAIL_IF_VALIDATION_ERROR': 'YES',
        'CPL_LOG_ERRORS': 'ON'
    }
)

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