Spring Integration SMB含@用户名认证失败：未知用户名问题求助

问题根源 #

spring-integration-smb底层依赖的JCIFS库会默认把用户名里的@当作用户名与域的分隔符。当你传入a_username@example.com作为用户名时，库会自动拆分出用户名a_username和域example.com，但你设置的domain是空字符串，导致认证时用的是错误的用户名+域组合，因此触发"unknown user name"错误。

而当你创建本地用户a_username后，因为域为空对应本地机器认证，此时库拆分出的a_username正好匹配本地用户，所以能正常登录。

解决办法 #

办法1：转义用户名中的@符号 #

把用户名里的@替换成URL转义符%40，让JCIFS不会将其解析为域分隔符：

var sessionFactory = new SmbSessionFactory();
sessionFactory.setSmbMinVersion(DialectVersion.SMB1);
sessionFactory.setSmbMaxVersion(DialectVersion.SMB311);
sessionFactory.setHost("example.com");
sessionFactory.setPort(445);
sessionFactory.setShareAndDir("example-share");
sessionFactory.setDomain("");
// 转义@为%40
sessionFactory.setUsername("a_username%40example.com");
sessionFactory.setPassword("******");

办法2：适配UPN格式的域用户配置 #

如果你的账号是域环境下的UPN格式（用户名@域名），可以把域设置为UPN的后缀，用户名只保留@前的部分：

var sessionFactory = new SmbSessionFactory();
// 其他配置不变
sessionFactory.setDomain("example.com");
sessionFactory.setUsername("a_username");
sessionFactory.setPassword("******");

办法3：开启扩展安全认证 #

尝试启用JCIFS的扩展安全认证，帮助正确处理UPN格式的用户名：

var sessionFactory = new SmbSessionFactory();
// 其他配置不变
sessionFactory.setUsername("a_username@example.com");
sessionFactory.setPassword("******");
// 开启扩展安全
sessionFactory.getConfig().setProperty("jcifs.smb.useExtendedSecurity", "true");

验证建议 #

• 优先试办法1，直接规避了库对@的错误解析，适配大多数场景；
• 若是域环境下的UPN用户，办法2更符合Windows认证规范；
• 前两种无效时，再尝试办法3。

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