远程PostgreSQL(PostGIS)执行ST_AsGDALRaster报错：无法加载GDAL驱动

修复方案 #

1. 确认GTIFF驱动在数据库端是否可用 #

登录远程PostgreSQL数据库，执行以下SQL查询，检查GTIFF驱动是否存在：

SELECT short_name, long_name FROM st_gdal_drivers() WHERE short_name ILIKE 'gtiff';

• 若查询无结果，说明PostGIS编译时未包含GTIFF驱动，或服务器GDAL库未正确配置。需联系运维人员重新编译PostGIS（确保包含GDAL的GTIFF支持），或更新GDAL/PostGIS版本。
• 若查询有结果，说明驱动存在，继续排查其他问题。

2. 确保驱动启用设置生效 #

你添加的SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';必须在ST_AsGDALRaster查询之前执行，且该设置仅对当前会话有效。修改Python代码如下：

import psycopg2

# DB Configuration
dbname = "Database"
dbuser = "user"
dbpass = "pass"
dbhost = "host.com"
dbport = "8080"

conn = None
try:
    conn = psycopg2.connect(database=dbname, user=dbuser, password=dbpass, host=dbhost, port=dbport)
    curs = conn.cursor()
    print("Database connected successfully")
    
    # 先启用所有GDAL驱动
    curs.execute("SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';")
    # 再执行栅格转换查询
    curs.execute("select ST_AsGDALRaster(st_union(rast), 'GTiff') from schema.table;")
    result = curs.fetchone()
except Exception as e:
    print(f"Error occurred: {e}")
finally:
    if conn:
        conn.close()

若不想每次连接都执行该设置，可要求运维人员在postgres.conf中配置全局参数：

postgis.gdal_enabled_drivers = 'ENABLE_ALL'

修改后重启PostgreSQL服务使配置生效。

3. 检查驱动名称的正确性 #

部分GDAL版本对驱动名称大小写敏感，尝试使用标准名称'GTiff'（首字母大写，其余小写）执行查询：

select ST_AsGDALRaster(st_union(rast), 'GTiff') from schema.table;

4. 验证合并后的栅格有效性 #

st_union(rast)可能生成无效栅格，导致转换失败。先执行以下查询验证栅格有效性：

SELECT ST_IsValid(st_union(rast)) FROM schema.table;

若返回false，说明合并后的栅格存在问题，需检查原始栅格数据（如重叠、投影不一致等），或尝试指定合并策略：ST_Union(rast, 'UNION')。

5. 检查服务器端GDAL环境配置 #

确保数据库服务器运行用户能访问GDAL依赖文件，且GDAL_DATA环境变量已正确设置（指向包含GDAL数据集的目录，如/usr/share/gdal）。可要求运维人员在PostgreSQL启动脚本中添加该环境变量，或检查系统环境配置。

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