Linux mountpoint 怎样判断目录是否是挂载点

在备份脚本里，最危险的误判之一是：数据盘没有挂载，脚本却把挂载目录当成普通目录继续写入。Linux 的 mountpoint 专门负责回答“这个文件或目录是不是挂载点”，最适合放在后续处理之前。

官方手册：https://man7.org/linux/man-pages/man1/mountpoint.1.html

最常用的判断是 mountpoint -q /path：退出码为 0 表示目标是挂载点，32 表示目标不是挂载点，1 通常表示参数、权限或系统错误。脚本不要把所有非 0 都当成“未挂载”。

先用 quiet 模式判断挂载点

mountpoint 可以接收目录，也可以接收文件。只想让脚本根据结果继续或停止时，使用 -q（--quiet）关闭正常提示，把判断交给退出码：

#!/usr/bin/env bash
# 目标：备份前确认数据目录确实位于一个挂载点。
target="${1:-/data}"

if mountpoint --quiet -- "$target"; then
  # 退出码 0 表示目标是挂载点，可以进入后续处理。
  echo "挂载点已确认：$target"
else
  status=$?
  # 先保留真实退出码，再由脚本决定是停止还是报警。
  echo "mountpoint 检查失败：$target，退出码=$status" >&2
  exit "$status"
fi

这里的 -- 用来把后面的内容视为路径参数，避免路径首字符与选项混淆。-q 只控制输出，不会改变挂载点判断规则，也不会执行挂载或卸载。

按 0、32、1 区分三类结果

批处理脚本最容易写错的地方，是把“不是挂载点”和“检查命令本身出错”合并处理。根据手册，三类退出状态可以这样理解：

因此，下面这种写法会丢失信息：

# 错误示例：把权限错误也误报成“没有挂载”。
if ! mountpoint -q -- "$target"; then
  echo "目录未挂载" >&2
  exit 1
fi

更稳妥的方式是显式读取返回码：

# 目标：区分正常的“不是挂载点”和真正的检查故障。
mountpoint -q -- "$target"
status=$?

case "$status" in
  0)
    # 目标是挂载点，继续执行备份或清理动作。
    echo "可以继续：$target"
    ;;
  32)
    # 目标存在但不是挂载点，避免把本地目录当成数据盘。
    echo "跳过未挂载目录：$target" >&2
    ;;
  *)
    # 1 等其它非预期状态需要保留，便于定位权限或系统问题。
    echo "检查命令异常：$target，退出码=$status" >&2
    exit "$status"
    ;;
esac

根据排障目的选择设备号和符号链接选项

基础判断之外，mountpoint 还有几个适合排障的选项。它们是读取或改变输出方式，不是挂载操作：

• -d 或 --fs-devno：显示目标目录上挂载设备的主、次设备号。
• --nofollow：路径最后一个元素是符号链接时，不跟随这个符号链接。
• --show：把给定路径解析到实际挂载点；它对 bind mount、符号链接或文件系统内的路径很有帮助，但需要内核支持 statmount(2)，手册注明 Linux 6.8 及更新内核才具备该支持，旧内核会报错。
• -x 或 --devno：改为检查给定设备并输出其主、次设备号，不再是目录挂载点判断。

# 只读取设备号；输出用于日志或后续人工排查。
mountpoint --fs-devno -- /data

# 处理符号链接路径时，不跟随最后一级链接。
mountpoint --nofollow --quiet -- /srv/current

# 需要解析路径实际落在哪个挂载点时使用 --show。
# 该选项依赖 statmount(2)，旧内核可能返回错误。
mountpoint --show -- /var/lib/app/cache

把判断封装进备份前检查

如果目标是“数据盘未挂载就不允许备份”，建议把检查封装成一个小函数，让调用方只接收清晰的成功、业务跳过和系统错误三种结果：

# 目标：把挂载点检查变成可复用的前置条件。
require_mountpoint() {
  local path="$1"
  local status

  mountpoint --quiet -- "$path"
  status=$?
  case "$status" in
    0)
      # 已确认是挂载点，函数正常返回。
      return 0
      ;;
    32)
      # 这是业务条件不满足，不伪装成系统故障。
      echo "不是挂载点：$path" >&2
      return 32
      ;;
    *)
      # 保留 mountpoint 的真实异常状态。
      echo "无法检查挂载点：$path，退出码=$status" >&2
      return "$status"
      ;;
  esac
}

if require_mountpoint "${1:-/data}"; then
  # 只有通过前置条件，才进入真正的备份逻辑。
  echo "开始处理已挂载目录"
else
  # 调用方可以根据 $? 决定重试、告警或安全退出。
  exit $?
fi

这个封装只证明路径处于挂载关系中，不证明目录里有预期文件，也不证明当前用户拥有读写权限。备份程序仍然需要自己的文件存在性、权限、空间和写入结果处理。

补上命名空间和版本边界

手册说明，支持 statmount(2) 的 Linux 6.8 及更新内核会使用这个接口，其他情况回退到读取 /proc/self/mountinfo。所以容器、服务进程和宿主机看到的挂载关系可能不同：排障时要在真正执行脚本的环境里判断，不能只在宿主机终端得出结论。

同时，mountpoint 只回答“是不是挂载点”。需要查看设备、文件系统类型、挂载选项或完整层级时，应另选 findmnt；需要真正挂载或卸载时，则分别使用权限和生命周期都经过设计的 mount、umount 流程。

常见问题

目录存在但为什么返回 32？

目录存在不等于它是挂载点。返回 32 的含义正是目标不是挂载点；普通目录、挂载点之外的路径和未生效的预期挂载都可能落入这个分支。

为什么不能把所有非 0 都写成“未挂载”？

因为 1 代表调用错误、权限问题或系统错误。把它改写成 32 会让备份或发布脚本在真正故障时继续执行，排障信息也会丢失。

--show 在旧系统上失败怎么办？

先把它视为能力不支持或系统错误，不要把失败当成“没有挂载”。如果只需判断挂载点，使用不依赖该选项的 mountpoint -q；如果必须解析实际挂载点，再确认执行环境的内核能力。

速记：判断用 mountpoint -q，0 是挂载点，32 是不是挂载点，1 是检查异常；设备号、符号链接、实际挂载点解析分别按需要选择对应选项。