如何使用Java Lambda函数访问Windows EC2上的共享文件夹

前置网络连通性配置 #

这是绝大多数人首次尝试会卡住的环节，跳过网络配置直接写代码100%无法连通：

• Lambda必须关联到与Windows EC2相同VPC的私有子网，Lambda对应的安全组需要放通到EC2的139、445端口（SMB协议标准端口）的TCP出站规则
• Windows EC2的AWS安全组需要配置入站规则，仅放行上述Lambda关联安全组的139、445端口访问，禁止对公网开放SMB端口
• 检查Windows EC2本地的系统防火墙，确保“文件和打印机共享”规则已放通对应端口，避免仅配置AWS层安全组、被本地系统防火墙拦截
• 确认VPC路由表无阻断内网访问的规则，Lambda能通过EC2的内网IP正常定位到实例，不要用EC2的公网IP走公网路径访问共享，既增加延迟也存在安全风险

技术选型说明 #

Java Lambda的运行环境是无状态Linux容器，不能直接用JDK原生File类拼接\\<EC2 IP>\<共享名>这类UNC路径——Linux原生文件系统根本不识别这类Windows路径格式，必须基于应用层SMB客户端库实现访问：

• 选用jcifs-ng作为SMB客户端依赖，这是原jCIFS库的持续维护分支，支持SMB2/SMB3协议，匹配当前Windows系统默认开启的SMB版本；不要用停止维护的老版本jCIFS，老版本仅支持已被Windows默认禁用的SMB1协议，必然连接失败
• 打包部署时用Maven Shade插件生成包含所有依赖的fat jar，避免Lambda运行时出现类找不到的异常

核心实现逻辑 #

参考可直接跑通的代码片段：

// 构造SMB认证对象
NtlmPasswordAuthenticator auth = new NtlmPasswordAuthenticator(
    "smb-read-user", // 提前在Windows上创建的专用访问账号
    "账号对应的访问密码",
    "" // 本地账号不需要填域信息，留空即可
);
// 初始化共享文件夹根路径
SmbFile smbShareRoot = new SmbFile(
    "smb://10.0.1.xx/业务共享目录/", // 替换为EC2内网IP和实际共享名
    auth
);
// 基础连通性校验
boolean isAccessible = smbShareRoot.canRead();
// 示例：读取共享下的目标文件
SmbFile targetDoc = new SmbFile(smbShareRoot, "业务数据.xlsx");
try (InputStream smbFileStream = new SmbFileInputStream(targetDoc)) {
    // 在这里补充后续的文件流处理逻辑即可
}

常见踩坑提示 #

• 不要直接用Windows内置的Administrator账号做SMB访问，Windows默认安全策略会限制内置管理员账号的网络访问权限，单独创建仅具备共享目录最小权限的本地专用账号，稳定性远高于用内置账号
• Lambda的执行超时时间至少设置为10s以上，SMB连接的建连握手存在固定网络开销，超时时间过短容易触发连接中断
• Lambda的内存配置不低于256MB，jcifs-ng库运行时的内存开销较低，但配置过低容易出现OOM导致的函数执行失败
• 不要尝试在Lambda容器里通过cifs-utils做系统级SMB挂载，Lambda运行容器不具备root权限，无法完成系统挂载操作，纯应用层客户端访问是唯一可落地的方案

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