Ubuntu下Docker容器.NET 5应用StreamWriter写入挂载目录权限被拒

你遇到的「生成空文件但写入/刷入失败、shell操作正常但.NET程序报错」是Azure Files SMB共享挂载到Linux宿主再透传到Docker容器的典型兼容问题，核心原因是.NET的IO操作对文件句柄的权限校验、刷盘逻辑和普通shell命令的行为不一致，和SMB挂载的默认参数冲突。

第一步：调整宿主侧Azure Files的挂载参数 #

你当前宿主上的Azure Storage文件共享使用默认参数挂载，需要修改挂载配置增加兼容.NET IO操作的参数：

1. 打开/etc/fstab文件，找到对应Azure Files的挂载行
2. 在挂载参数中新增noserverino,nounix,file_mode=0777,dir_mode=0777,uid=0,gid=0，完整挂载参数示例如下：

//<存储账户名>.file.core.windows.net/<共享名> /mount/sgbatchprdctother/output cifs nofail,vers=3.0,username=<存储账户名>,password=<存储账户密钥>,noserverino,nounix,file_mode=0777,dir_mode=0777,uid=0,gid=0 0 0

3. 重新挂载对应共享：

sudo umount /mount/sgbatchprdctother/output
sudo mount /mount/sgbatchprdctother/output

参数说明：

• nounix：禁用SMB的Unix扩展，避免.NET对文件inode、权限位的校验和SMB服务端逻辑冲突
• file_mode=0777、dir_mode=0777：强制所有文件/目录权限为777，消除权限位校验问题
• uid=0,gid=0：强制所有文件归属root用户，匹配你容器内进程的运行身份

第二步：调整Docker挂载参数 #

创建容器时给-v挂载增加:z参数，消除Docker挂载命名空间隔离带来的权限限制：

sudo docker container create --name worker \
-v /mount/qzhzntgf6r5uaxjp2vov/prdct-other/prdct-test/configs:/mount/configs:z \
-v /mount/qzhzntgf6r5uaxjp2vov/prdct-other/prdct-test/catalogs:/mount/catalogs:z \
-v /mount/sgbatchprdctother/output:/mount/output:z \
imagename:tag

第三步：调整.NET写入逻辑适配SMB文件系统 #

针对SMB文件系统的延迟特性，修改代码增加显式的文件创建逻辑，避免默认创建的文件权限不足：

public async static Task WriteTextToFileAsync(string fileName, string text, bool append)
{
    CreateDirectoryIfNotExists(fileName);
    // 非追加写入的新文件，先创建文件再写入
    if (!append && !File.Exists(fileName))
    {
        using (var fs = File.Create(fileName, 4096, FileOptions.Asynchronous))
        {
            await using var sw = new StreamWriter(fs);
            await sw.WriteAsync(text).ConfigureAwait(false);
        }
        return;
    }
    using (StreamWriter outfile = new StreamWriter(fileName, append))
    {
        await outfile.WriteAsync(text).ConfigureAwait(false);                
    }
}

修改完成后重启容器执行写入测试，即可解决权限报错问题。

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