Docker中ASP.NET Core 6 MVC应用读写Windows共享文件夹问题

1. 定位核心问题 #

直接在代码里使用\\Servername\FolderName这类Windows共享路径，在Linux容器中会被解析为容器内部路径，导致文件实际存储在容器内，重启后丢失。必须通过SMB协议直接访问Windows共享，而非依赖系统路径解析。

2. 先排除环境/权限问题（代码外验证） #

在容器内部手动测试SMB连接，明确是权限还是网络问题：

• 进入容器终端，安装smbclient（Debian/Ubuntu容器执行apt update && apt install smbclient）
• 执行连接命令：smbclient //Servername/FolderName -U DOMAIN\Username%Password
  • 若能进入交互模式，说明网络和账号权限正常，问题出在代码实现
  • 若报错，根据提示定位：
    • NT_STATUS_LOGON_FAILURE：域账号密码错误或账号无访问权限
    • NT_STATUS_CONNECTION_REFUSED：Windows服务器445端口不通，检查防火墙或网络路由
    • NT_STATUS_ACCESS_DENIED：共享文件夹的共享权限和NTFS权限未给该账号分配读写权限（需同时检查Windows共享设置的两个页面）

3. 代码层面正确实现SMB读写 #

不要用File类直接操作Windows路径，改用SMB客户端库实现：

示例代码（基于SMBLibrary）

using SMBLibrary;
using SMBLibrary.Client;
using System.IO;

// 配置共享信息
string serverName = "Servername";
string shareName = "FolderName";
string fileName = "FileName.xlsx";
var credentials = new NetworkCredential("YourUsername", "YourPassword", "YourDomain");

try
{
    using var smbClient = new SmbClient();
    // 建立SMB连接（默认445端口）
    smbClient.Connect(serverName, SMBTransportType.DirectTCPTransport);
    // 登录共享目录
    smbClient.Login(shareName, credentials);

    // 写入文件到共享
    using var writeStream = smbClient.CreateFile($"{shareName}/{fileName}", 
        FileAccessMask.GENERIC_WRITE, 
        CreateDisposition.CreateAlways, 
        FileAttributes.Normal);
    var fileContent = File.ReadAllBytes("/path/to/local/temp/file.xlsx"); // 替换为你的源文件内容
    writeStream.Write(fileContent, 0, fileContent.Length);

    // 读取共享文件示例
    using var readStream = smbClient.OpenFile($"{shareName}/{fileName}", FileAccessMask.GENERIC_READ);
    var buffer = new byte[4096];
    int bytesRead;
    using var localStream = new FileStream("/path/to/local/output.xlsx", FileMode.Create);
    while ((bytesRead = readStream.Read(buffer, 0, buffer.Length)) > 0)
    {
        localStream.Write(buffer, 0, bytesRead);
    }
}
catch (UnauthorizedAccessException ex)
{
    // 明确捕获权限错误
    Console.WriteLine($"权限错误：域账号{credentials.UserName}无法访问//{serverName}/{shareName}，详情：{ex.Message}");
}
catch (SocketException ex)
{
    // 网络连接错误
    Console.WriteLine($"网络连接失败：无法连接到{serverName}的445端口，详情：{ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"操作失败：{ex.Message}\n堆栈信息：{ex.StackTrace}");
}

• 注意：路径使用Linux风格的/，而非Windows的\
• 容器需安装SMB依赖：Debian/Ubuntu容器执行apt install libsmbclient-dev，CentOS/RHEL执行yum install libsmbclient-devel

4. 优化错误排查 #

通过细分异常类型，精准定位问题：

• UnauthorizedAccessException：直接指向账号权限或共享权限配置问题
• SocketException：指向网络连通性（端口、防火墙）问题
• 其他异常：检查代码逻辑或SMB库版本兼容性

5. 容器网络配置 #

确保容器能访问Windows服务器的445端口：

• 检查Linux主机防火墙是否放行出站445端口
• 检查Windows服务器防火墙是否允许来自容器所在网络的SMB（445端口）请求
• 若容器使用自定义网络，确保网络模式能路由到Windows服务器

内容的提问来源于stack exchange，提问作者Rémy