如何在 SMBJ 中正确设置远程文件的权限模式（File Mode）-java教程-PHP中文网

如何在 SMBJ 中正确设置远程文件的权限模式（File Mode）

本文详解使用 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();
}</smb2createoptions></smb2shareaccess></fileattributes>

⚠️ 重要注意事项：

服务端要求：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。