QGIS插件中使用VSIS3加载栅格时如何配置AWS凭证？

方法1：利用已设置的环境变量（推荐） #

既然你已经将AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY设为环境变量，GDAL的VSIS3驱动会自动读取这些变量，无需修改layer_uri。只要QGIS进程能获取到这些环境变量，直接使用原URI创建图层即可：

layer_uri = "/vsis3/bucket/key"
raster_layer = QgsRasterLayer(layer_uri, "S3 Raster")

如果需要在插件内动态设置环境变量，要确保在创建QgsRasterLayer之前执行：

import os
os.environ['AWS_ACCESS_KEY_ID'] = '你的访问密钥ID'
os.environ['AWS_SECRET_ACCESS_KEY'] = '你的私有访问密钥'

方法2：将凭证嵌入URI #

若不想依赖环境变量，可直接把凭证编码进VSIS3 URI，结构如下：

/vsis3/访问密钥ID:私有访问密钥@bucket/key

示例代码：

layer_uri = "/vsis3/AKIAXXXXXX:abc123XXXXXX@my-bucket/my-raster.tif"
raster_layer = QgsRasterLayer(layer_uri, "带凭证的S3栅格")

⚠️ 注意：此方式会直接暴露凭证，在代码版本控制、日志输出场景存在安全风险，仅建议用于测试环境。

方法3：通过GDAL配置API设置 #

可以借助QGIS封装的GDAL配置接口，在创建图层前单独指定VSIS3的凭证参数，无需修改URI或全局环境变量：

from osgeo import gdal

# 设置GDAL专属配置项
gdal.SetConfigOption('AWS_ACCESS_KEY_ID', '你的访问密钥ID')
gdal.SetConfigOption('AWS_SECRET_ACCESS_KEY', '你的私有访问密钥')

# 创建栅格图层
layer_uri = "/vsis3/bucket/key"
raster_layer = QgsRasterLayer(layer_uri, "S3 Raster")

这种方式的优势是可以针对特定操作单独配置凭证，不会影响全局环境变量的其他使用场景。

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