QSsh RemoveDir 删除远程目录失败的常见原因有哪些？

Question

QSsh RemoveDir 删除远程目录失败的常见原因包括：① 目录非空（QSsh 的 `removeDirectory()` 仅支持删除**空目录**，不递归）；② 权限不足（远程用户无目录写/执行权限，或受 SELinux/AppArmor 限制）；③ 路径错误（如使用相对路径未基于正确工作目录，或含非法字符、符号链接未解析）；④ SFTP 服务端限制（如 OpenSSH 配置 `SFTPSubsystem` 禁用 `rmdir`，或启用了只读模式）；⑤ QSsh 底层异常未捕获（如连接中断、超时、协议不兼容导致返回静默失败）。特别注意：QSsh 不提供 `rm -rf` 等价功能，需先递归删除子项（遍历+`removeFile()`/`removeDirectory()`），再删父目录。建议结合 `ls()` 检查目录内容，并用 `lastError()` 和 `errorString()` 定位具体失败原因。

Answer 1

```html

一、现象层：QSsh removeDirectory() 静默失败的典型表征

调用 QSsh::SftpChannel::removeDirectory("/path/to/dir") 返回 false，但无明确错误日志；lastError() 为 QProcess::UnknownError 或 SftpOperationNotSupported；目录在远程端依然存在。该现象常误导开发者误判为“逻辑未执行”，实则已触发协议级拒绝。

二、协议层：SFTP 协议语义与 QSsh 实现约束

• SFTP RFC 4335（及 OpenSSH 实现）中 SSH_FXP_RMDIR 请求严格要求目标目录为空，否则服务器必须返回 SSH_FX_FAILURE 或 SSH_FX_NOT_EMPTY。
• QSsh 的 removeDirectory() 是对 SSH_FXP_RMDIR 的直译封装，不包含递归遍历逻辑——这与 POSIX rmdir(2) 行为一致，但与用户直觉中的 rm -rf 存在根本性鸿沟。
• 对比：removeFile() 可删除任意文件（含符号链接指向目标），但 removeDirectory() 对符号链接本身无效（需先 readLink() 判断是否为 dangling link）。

三、权限与安全策略层：超越传统 Unix 权限的隐式拦截

拦截源	典型表现	验证命令（远程执行）
SELinux sftpd_t 策略	errorString() 含 "Permission denied (13)"，但 ls -ld 显示权限正常	ausearch -m avc -ts recent | grep rmdir
OpenSSH ForceCommand 限制	连接后首次 ls() 成功，但 removeDirectory() 触发 channel 关闭	sshd -T | grep -i forcecommand

四、路径解析层：符号链接、相对路径与 chroot 的三重陷阱

QSsh 的路径解析不自动调用 realpath()：若 /home/user/data → /mnt/nas/data，调用 removeDirectory("data")（相对路径）将尝试删除 $HOME/data 而非实际挂载点；若服务端启用 ChrootDirectory，且客户端未显式 cd() 至根，则 "./subdir" 可能被解析为 chroot/subdir 外的非法路径。建议始终使用 absolutePath() + ls() 双校验：

auto job = sftp->ls("/target");
job->waitForFinished();
if (job->error() == SftpNoError && job->listing().isEmpty()) {
    sftp->removeDirectory("/target"); // 安全前提
}

五、工程实践层：构建健壮的递归删除工具链

graph TD
  A[调用 removeRecursiveDir] --> B{ls /path 返回列表?}
  B -->|否| C[检查 lastError/errorString]
  B -->|是| D[遍历 listing]
  D --> E{entry.isDir?}
  E -->|是| F[递归 removeRecursiveDir entry.filename]
  E -->|否| G[removeFile entry.filename]
  F --> H[等待子任务完成]
  G --> H
  H --> I[removeDirectory /path]
  I --> J[返回最终状态]

六、调试诊断层：从静默失败到精准归因的排查矩阵

当 removeDirectory() 失败时，应按此顺序执行诊断：

1. 立即捕获 sftp->lastError() 和 sftp->errorString()（注意：部分错误仅在下一次异步操作后才刷新）；
2. 用同一连接执行 ls("/path")，确认返回值类型（SftpListJob）、是否超时、是否含 SSH_FX_PERMISSION_DENIED；
3. 启用 QSsh 底层日志：qputenv("QT_SSH_DEBUG", "1")，观察 raw SFTP packet 中 RMDIR 的响应码；
4. 在服务端抓包：tcpdump -i any port 22 -w sftp.pcap，用 Wireshark 过滤 sftp.cmd == 0x0d（RMDIR opcode）；
5. 交叉验证：用 sftp -v user@host 手动执行 rmdir /path，比对服务端拒绝原因。

```