如何在不加载至内存的情况下用GDAL从SMB服务器打开文件？

你直接用gdal.Open(f)行不通，因为GDAL的Open()函数不接受Python文件对象，而且读全文件到内存的方式也不符合需求。下面给两种可以按需读取、不加载全文件的解决方案：

方法一：用GDAL原生SMB虚拟文件系统（推荐） #

GDAL自带SMB虚拟文件系统支持，直接构造特定格式的路径，让GDAL自己处理SMB连接，它会按需读取数据，不会一次性把整个文件塞进内存。

步骤和代码：

1. 先设置SMB的用户名和密码作为GDAL配置项
2. 用/vsismb/开头的路径格式打开文件

from osgeo import gdal

# 配置SMB认证信息
gdal.SetConfigOption('SMB_USERNAME', 'user')
gdal.SetConfigOption('SMB_PASSWORD', 'pass')

# 用GDAL的SMB虚拟路径打开文件，按需读取
raster = gdal.Open('/vsismb/server/file.tif')

# 示例操作：获取栅格基本信息
if raster:
    print(f"栅格尺寸: {raster.RasterXSize} × {raster.RasterYSize}")
    band = raster.GetRasterBand(1)
    print(f"波段数据类型: {gdal.GetDataTypeName(band.DataType)}")
    # 用完记得释放资源，避免内存泄漏
    raster = None

方法二：包装smbclient文件对象为GDAL虚拟句柄 #

如果必须用smbclient来管理SMB连接（比如有特殊认证逻辑），可以把smbclient的文件对象包装成GDAL能识别的虚拟文件句柄，这样GDAL依然能按需读取，不会加载全文件。

注意：要确保smbclient打开的文件支持随机访问（mode="rb"默认支持），因为GDAL读取栅格需要随机定位。

import smbclient
from osgeo import gdal

with smbclient.open_file(r"\\server\file.tif", username="user", password="pass", mode="rb") as f:
    # 将Python文件对象包装成GDAL的VSI文件句柄
    vsi_handle = gdal.VSIFOpenL(f, 'rb')
    if vsi_handle:
        # 通过虚拟句柄打开栅格文件
        raster = gdal.Open('/vsimem/temp.tif', gdal.GA_ReadOnly, open_options=['VSIHandle=' + str(vsi_handle)])
        if raster:
            print(f"栅格投影: {raster.GetProjectionRef()}")
            # 释放资源
            raster = None
        # 关闭VSI句柄
        gdal.VSIFCloseL(vsi_handle)

两种方法对比：

• 方法一最省心，GDAL原生支持，不需要额外处理文件对象，优先选这个
• 方法二更灵活，适合需要自定义SMB连接逻辑的场景

内容的提问来源于stack exchange，提问作者Math-dude