system.io 直接访问 unc 路径失败主因是 smb 认证不透明，建议用 wnetaddconnection2 显式挂载并配对 wnetcancelconnection2 清理，避免凭据冲突或残留。
为什么 System.IO 直接访问 \servershare 有时失败？
因为 Windows 网络共享（Samba/CIFS）的认证和会话管理不透明，System.IO 的 File.Exists、Directory.GetFiles 等方法底层依赖系统级 SMB 会话。一旦当前登录用户没权限、凭据缓存过期、或目标共享启用了“仅限 Kerberos”策略，就会静默失败或抛出 UnauthorizedAccessException 或 IOException。
常见错误现象：
-
UnauthorizedAccessException：即使手动能打开资源管理器访问，代码却报错 -
IOException：“网络路径不存在”——实际存在，但未建立有效会话 - 首次调用慢、后续快：系统在后台做 NTLM 协商，不可控
实操建议：
- 不要依赖
System.IO做连接性判断，它不暴露认证过程 - 用
WNetAddConnection2（Windows API）显式挂载映射盘符，再操作Z:路径，控制力更强 - 挂载前确保目标服务器支持 SMBv2/v3（Win10+/Server 2016 默认禁用 SMBv1），否则连接直接被拒
如何用 WNetAddConnection2 安全建立 CIFS 连接？
这是最稳定、兼容性最好的方式，绕过 .NET 对网络路径的黑盒处理，把认证逻辑收归自己手上。
关键点：
- 必须 P/Invoke
WNetAddConnection2，参数中dwFlags设为CONNECT_UPDATE_PROFILE才会持久化凭据（可选），设为0则只本次进程有效 -
lpRemoteName必须是 UNC 格式："\\server\share"（注意双反斜杠转义） - 用户名要带域前缀：
"DOMAIN\user"或"user@domain.com"；纯用户名在跨域时大概率失败 - 调用后务必检查返回值：
0成功，非0查netapi32.dll错误码（如1219表示已有同名连接）
简短示例（省略 DllImport 声明）：
var result = WNetAddConnection2(
ref netResource,
"password",
"DOMAIN\user",
0
);
if (result != 0) {
throw new InvalidOperationException($"WNet failed: {result}");
}
// 后续可用 File.Copy(@"Z: ile.txt", @"C:local.txt");
.NET 6+ 能否不用 P/Invoke？NetworkCredential 和 SmbClient 可靠吗？
不能。.NET 原生库至今（包括 .NET 8）**没有内置 Samba/CIFS 客户端实现**。NetworkCredential 只是凭据容器，本身不发起连接；SmbClient 是社区项目（如 SharpCifs），不是微软官方组件，且多数已停止维护或仅支持 SMBv1（不安全、Win10+ 默认禁用）。
现状：
-
System.Net.Http、System.Net.Sockets都无法直连 SMB 协议——它不是 HTTP，也不是裸 TCP - 第三方库如
LibSmb2（C# 封装）依赖 native dll，部署复杂，Linux/macOS 兼容性差 - 若目标是 Linux Samba 服务，务必确认其
smb.conf中server min protocol = SMB2，否则 .NET 进程可能协商失败
所以：Windows 平台优先用 WNetAddConnection2；跨平台需求强烈时，改用 WebDAV（需服务端配合）或 SSH/SFTP（需开启 OpenSSH Server），而非硬啃 SMB。
挂载后如何清理、避免残留连接？
每次成功调用 WNetAddConnection2 后，必须配对调用 WNetCancelConnection2，否则连接会滞留在系统会话中，下次挂载同名资源时可能复用旧凭据导致权限错乱，或触发 ERROR_SESSION_CREDENTIAL_CONFLICT（错误码 1219）。
实操要点：
- 用
try/finally或using（封装成IDisposable类）确保取消调用执行 -
WNetCancelConnection2的dwFlags若设为CONNECT_UPDATE_PROFILE，会同时删注册表凭据缓存 - 测试时别用
net use *手动删映射——它可能删掉别人正在用的连接，应指定盘符：net use Z: /delete - 进程崩溃时连接不会自动释放，需在服务场景加全局异常钩子兜底
真正麻烦的从来不是第一次连上，而是连上之后忘了断、断得不干净、或者断了又立刻重连触发 Windows 凭据锁死——这些细节比协议本身更耗时间。
