1. 先搞清楚一件事:Java到底是怎么碰"共享文件"的
很多刚接触这个需求的同学会带着这样一个疑问:共享文件不就是网上邻居里双击就能打开的东西吗?Java要读它,难道还要装什么额外软件?
实际上,共享文件的本质是操作系统层面的文件共享协议,跟Java这门语言本身没有半毛钱关系。Windows 环境下最常见的是 SMB/CIFS 协议(也就是你网上邻居里看到的那些共享文件夹),Linux 环境下则是 NFS 协议。Java 要读取这些共享文件,本质上只有两条路:一是直接基于协议去访问,二是把远程共享路径挂载到本地文件系统后再当普通文件读。
这两条路我在实际项目里都走过,体验差别非常大。最直接的感受是:如果用错了方案,你会在"字符集乱码"和"Socket 超时"这两个坑里反复横跳,最后发现根本不是代码的问题,而是协议层选型就错了。
所以在看任何代码之前,先花两分钟搞清楚你的目标服务器是什么系统、开放的是哪种共享协议、给你的账号是什么权限级别。这几件事没确认清楚,写出来的代码大概率只能在自己电脑上跑通,一到生产环境就翻车。
以我手头一个实际项目为例:需求是从一台 Windows Server 2019 的共享目录里定时拉取当天的交易报表,文件大概有几十 MB,每天凌晨生成。目标服务器开了 SMB 共享,给了一个专门的只读服务账号。这个场景我最终采用的是 SMBJ 库直连协议,下面把完整落地过程,以及中间踩过的坑都写出来。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 依赖选型:为什么我弃用了 JCIFS,改用 SMBJ
Java 生态里访问 SMB 共享文件,绕不开两个库:老牌的 JCIFS,以及现在更推荐的 SMBJ。网上不少教程还在推 JCIFS,但那是很多年前的经验了。直接说结论:新项目别用 JCIFS,它只支持到 SMB1 协议,而 SMB1 在现代操作系统里默认是关闭的,甚至因为安全漏洞被强制禁用。
SMB1 是什么概念?它是 1980 年代就存在的协议版本,网络上横行了几十年的"永恒之蓝"勒索病毒,攻击路径就是 SMB1。所以服务器安全加固的第一条就是把 SMB1 禁用掉。你拿 JCIFS 去连一台 Windows Server 2019,大概率会得到类似于"连接被拒绝"或者"不支持请求的协议"这类错误,排查半天还以为是自己代码写错了。
SMBJ 则完全解决了这个问题:
| 对比维度 | JCIFS | SMBJ |
|---|---|---|
| 协议版本 | 仅支持 SMB1 | 支持 SMB1、SMB2、SMB3 |
| 维护活跃度 | 多年未实质性更新 | 持续维护,社区活跃 |
| 与新版 Windows 兼容性 | 差 | 好 |
| 依赖体积 | 较小但功能局限 | 略大但功能完整 |
| 线程安全 | 一般 | 更好 |
SMBJ 的使用方式也很有意思,它提供了一套非常接近"用浏览器访问 URL"的体验。你指定一个 smb:// 协议的地址、用户名、密码,然后就可以像操作本地文件一样读取远程目录列表和文件内容了。
Maven 依赖就一段:
xml复制<dependency>
<groupId>com.hierynomus</groupId>
<artifactId>smbj</artifactId>
<version>0.13.0</version>
</dependency>
注意:SMBJ 底层依赖了 Slf4j 做日志输出,如果项目里已经有别的日志框架,记得检查一下冲突。我在实际项目中就遇到过一次因为 Logger 绑定冲突导致 SMBJ 内部异常被吞掉的情况,排查起来极其恶心。建议引入后先跑一个最小用例,确认日志能正常输出再往下走。
3. 核心代码实战:从连接认证到文件读取的完整落地
3.1 建立 Session 与连接池设计
拿到 SMBJ 之后,第一步要建立与目标服务器的连接。SMBJ 的核心对象关系是这样的:SMBClient 负责发起底层连接,通过 authenticate 方法获得一个 Session,再通过 Session 获取 Share(共享目录),最后在 Share 上操作文件。
一个容易忽略的点是:SMBClient 的实例建议复用,不要每次读取文件都 new 一个。因为每次连接都有完整的 TCP 握手、SMB 协议协商、用户认证三步,开销不小。如果文件拉取频率高,频繁创建连接会白白消耗服务器资源,也可能触发服务器的连接数限制。
我习惯用一个简单的单例管理类来持有 SMBClient:
java复制public class SmbClientHolder {
private static final SMBClient CLIENT = new SMBClient();
public static SMBClient getClient() {
return CLIENT;
}
}
然后每次操作文件时,通过 Client 建立 Session:
java复制SMBClient client = SmbClientHolder.ge
