本文详解使用 smbj 库设置 smb 共享中文件权限（如 755）时遇到 status_invalid_parameter 错误的根本原因与正确实践，涵盖 openfile/opendirectory 的语义差异、 filemodeinformation 的适用前提及完整可运行代码示例。
本文详解使用 smbj 库设置 smb 共享中文件权限（如 755）时遇到 status_invalid_parameter 错误的根本原因与正确实践，涵盖 openfile/opendirectory 的语义差异、 filemodeinformation 的适用前提及完整可运行代码示例。
在 SMB 协议（尤其是 SMB2/SMB3）中，文件权限（file mode）并非通用文件属性，而是 UNIX 扩展（SMB2 Unix Extensions）特有概念，且仅对支持该扩展的服务器（如 Samba 4.8+、FreeNAS、TrueNAS）生效。SMBJ 提供的 FileModeInformation 类正是为这一场景设计的，但其使用有严格前提：必须通过 openDirectory() 或 openFile() 获取一个 已启用 UNIX 扩展上下文 的句柄，且目标路径需为文件（非目录），同时服务端必须实际支持并启用 UNIX 扩展。
你原始代码中的关键问题在于：
- ❌ 错误地对目录路径 "folder01/abc.sh" 使用了 FILE_ATTRIBUTE_DIRECTORY 和 FILE_DIRECTORY_FILE —— 这会强制 SMBJ 尝试以目录方式打开，而 FileModeInformation 仅适用于普通文件；
- ❌ openFile() 调用中传入了 FILE_ATTRIBUTE_DIRECTORY，语义矛盾（文件不能同时是目录）；
- ❌ 未验证服务端是否启用 UNIX 扩展（需服务端配置 server min protocol = SMB2 且 vfs objects = unix_extensions 等）；
- ❌ AccessMask.GENERIC_ALL 在部分服务端可能触发权限校验失败，推荐使用更精确的掩码（如 AccessMask.FILE_WRITE_ATTRIBUTES）。
✅ 正确做法如下（以设置普通文件 abc.sh 的权限为 0755 为例）：
// 1. 确保连接已启用 UNIX 扩展（关键！）
Connection connection = session.getConnection();
if (!connection.getNegotiatedProtocol().isUnixExtensionsSupported()) {
throw new IllegalStateException("Server does not support UNIX extensions");
}
// 2. 以文件方式打开（非目录），使用 FILE_ATTRIBUTE_NORMAL
Set<FileAttributes> fileAttrs = EnumSet.of(FileAttributes.FILE_ATTRIBUTE_NORMAL);
Set<SMB2ShareAccess> shareAccess = EnumSet.of(
SMB2ShareAccess.FILE_SHARE_READ,
SMB2ShareAccess.FILE_SHARE_WRITE,
SMB2ShareAccess.FILE_SHARE_DELETE
);
Set<SMB2CreateOptions> createOptions = EnumSet.noneOf(SMB2CreateOptions.class);
// 注意：不要添加 FILE_DIRECTORY_FILE！这是文件操作
// 3. 使用最小必要访问权限（WRITE_ATTRIBUTES 足够设置 mode）
File file = share.openFile(
"folder01/abc.sh",
EnumSet.of(AccessMask.FILE_WRITE_ATTRIBUTES), // ✅ 精准权限
fileAttrs,
shareAccess,
SMB2CreateDisposition.FILE_OPEN_IF,
createOptions
);
try {
// 4. 设置 UNIX 文件模式（八进制整数，如 0755 → 493）
file.setFileInformation(new FileModeInformation(0755));
System.out.println("File mode set successfully to 0755");
} finally {
file.close();
}⚠️ 重要注意事项：
- 服务端要求：Samba 配置中必须启用 unix extensions = yes（默认开启，但某些容器镜像或精简版可能关闭），且共享需挂载为 cifs 并指定 unix_extensions 选项；
- 路径有效性：确保 "folder01/abc.sh" 是真实存在的 文件，而非目录；若需设置目录权限，请改用 openDirectory() + setFileInformation()（同样需 UNIX 扩展）；
- 权限掩码：AccessMask.FILE_WRITE_ATTRIBUTES 是设置文件模式所需的最小权限，避免使用 GENERIC_ALL 引发服务端拒绝；
- 错误诊断：若仍报 STATUS_INVALID_PARAMETER，请启用 SMBJ 日志（log.level=DEBUG）检查 Negotiate Response 中是否包含 UNIX_EXTENSIONS 标志；
- 替代方案：若服务端不支持 UNIX 扩展，无法通过 SMB 协议直接设置 POSIX 权限，需改用 SSH/SFTP 或服务端脚本（如 smbexec）间接执行 chmod。
综上，FileModeInformation 不是“万能 chmod”，而是 UNIX 扩展协议下的专用能力。成功的关键在于：协议协商确认、句柄类型匹配、服务端配置就绪、访问权限精准。遵循上述步骤，即可稳定实现 SMB 共享中文件权限的程序化管理。
