C#调用BeeGFS必须通过POSIX挂载点访问，不可直连；需确保挂载就绪、用户权限匹配、禁用自动挂载；大文件写入应显式设置大缓冲并手动Flush；目录遍历宜用opendir/readdir或beegfs-ctl替代Directory.GetFiles；UID/GID映射错位是AccessDenied主因，须检查uidShift配置。
用 C# 调用 BeeGFS，本质是走 POSIX 兼容层，不是直连
BeeGFS 本身不提供原生 .NET 客户端，C# 程序想读写它，必须依赖系统级挂载——也就是把 BeeGFS mount 到本地路径（如 /mnt/beegfs），然后像操作普通 Linux 文件系统一样用 System.IO 或 FileStream 访问。试图绕过挂载、用 HTTP 或自定义协议直连 BeeGFS 控制节点，会失败，因为 BeeGFS 没开放这类接口。
常见错误现象：DirectoryNotFoundException 或 UnauthorizedAccessException，往往不是权限配置问题，而是程序运行用户没权限访问挂载点，或挂载本身未就绪（比如 mount 命令在后台异步执行完前就启动了 C# 进程）。
- 确保 mount 已完成且状态正常：
mount | grep beegfs和ls -l /mnt/beegfs都应返回有效结果 - C# 进程需以能访问该挂载点的用户身份运行（通常不是 root，而是集群统一的计算用户，如
hpcuser） - 不要在代码里尝试“自动 mount”——
Process.Start("mount", "...")不可靠，挂载耗时不可控，且子进程权限常与父进程不一致
大文件并发写入 BeeGFS，FileStream 的缓冲和 flush 必须手动控制
BeeGFS 对小 I/O 不友好，频繁 Write() 小块数据（比如每次 4KB）会严重拖慢吞吐，甚至触发元数据服务器瓶颈。默认 FileStream 缓冲区（4KB 或 8KB）在高并发下极易成为争用点，且 Dispose() 触发的隐式 Flush() 可能阻塞数秒。
使用场景：科学计算中生成 TB 级 HDF5 或二进制矩阵切片，多个 worker 进程同时写不同子目录下的文件。
- 显式设置大缓冲区：
new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None, bufferSize: 1024 * 1024)（1MB） - 避免依赖
using自动释放——改用try/finally，在finally中先调stream.Flush(true)（强制刷到存储），再stream.Close() - 写入完成后，用
File.SetAttributes(path, FileAttributes.Normal)清除临时属性（某些 BeeGFS 客户端挂载选项会设noatime或relatime，但 .NET 可能误判）
Directory.GetFiles() 在 BeeGFS 上极慢？换 opendir/readdir 的 P/Invoke 方案
Directory.GetFiles("/mnt/beegfs/data", "*.bin") 在百万级文件目录下可能卡住几十秒——因为 .NET 默认走 FindFirstFileEx（Windows）或 readdir + 全量过滤（Linux），而 BeeGFS 的目录遍历延迟比本地 ext4 高一个数量级，且不支持服务器端通配符过滤。
性能影响：单次扫描耗时从毫秒级升至分钟级，且会阻塞整个线程。
- Linux 下直接 P/Invoke
opendir/readdir，跳过 .NET 的封装开销，自己做后缀匹配（string.EndsWith(".bin")） - 避免递归：
Directory.GetFiles(..., SearchOption.AllDirectories)在 BeeGFS 上几乎不可用，元数据树深度大时易超时 - 如需高频列举，考虑用 BeeGFS 自带的
beegfs-ctl --list-dir命令 +Process.Start解析输出（注意 stderr 重定向，失败时它写 stderr 而非 stdout）
权限与 UID/GID 映射错位导致 AccessDenied，检查 /etc/beegfs/beegfs-client.conf 的 uidShift
C# 进程看到的文件权限（File.GetAccessControl()）和实际 BeeGFS 行为可能不一致——根本原因是 BeeGFS 客户端默认启用 UID/GID 映射（尤其在容器或跨集群环境），比如把容器内 UID 1001 映射成宿主机 UID 5001，而你的 C# 进程仍以 1001 运行，却试图访问属主为 5001 的文件。
错误信息典型表现：UnauthorizedAccessException 即使 ls -l 显示权限为 rw-r--r--；File.Exists() 返回 false 但 ls 能列出。
- 查客户端配置：
grep uidShift /etc/beegfs/beegfs-client.conf，若值非 0，说明启用了偏移 - 确认当前进程 UID：
System.Environment.GetEnvironmentVariable("UID")或Process.GetCurrentProcess().Id不够，得用libc.getuid()P/Invoke - 临时调试可加挂载参数：
-o uidShift=0（重启 client 后生效），但生产环境需统一 UID 规划，而非关映射
最常被忽略的是：BeeGFS 的 UID 映射发生在内核模块层，.NET 的任何文件 API 都无法绕过它——你看到的“权限”，已经是映射后的结果。别在 C# 里硬改 ACL，先对齐 UID 生态。
