Linux dm-multipath路径显示异常怎么查?如何核对设备映射与链路状态
业务侧看到 /dev/mapper/data_lun 仍然存在,但 multipath -ll 原本显示的两条路径只剩一条;或者 lsblk 已经列出两块指向同一存储 LUN 的磁盘,多路径映射却始终不出现。这两种现象不能直接归为“链路断了”:前者要区分路径确实失联,还是被 multipathd 判为不可用;后者还要检查设备 WWID、黑名单和成图条件。
排查时先核对“主机看到了什么”,再核对“dm-multipath 接纳了什么”,最后才考虑修改配置或触碰链路。尤其在承载文件系统、LVM 或数据库的主机上,不要为了让路径重新显示就先执行重启服务、清空映射或重新扫描所有存储设备。
先确认异常落在哪一层
操作前记录预期的 LUN WWID、应有路径数,以及路径分别经过哪些主机端口和存储控制器。如果没有这些信息,至少先从正常主机、存储侧映射记录或变更单核对;不要仅凭 /dev/sdb、/dev/sdc 判断它们属于同一个 LUN。sdX 名称可能随扫描和重启变化。
在使用 systemd 的 Linux 主机上,先运行只读命令:
systemctl status multipathd --no-pager
multipath -ll
multipathd show paths
lsblk -o NAME,TYPE,SIZE,WWN,FSTYPE,MOUNTPOINT
multipath -ll 展示已建立的多路径映射及路径状态;multipathd show paths 用于观察守护进程当前掌握的路径;lsblk 则从内核块设备层确认磁盘是否存在,并提示上层是否挂载或用于其他用途。不同发行版、multipath-tools 版本的输出字段可能不同,应以 WWID、映射名、路径设备名和状态为主要核对对象。
先按结果分流:

- 预期的
sdX在lsblk中也不存在:优先查存储呈现、FC/iSCSI 会话及内核发现过程。此时改multipath.conf通常不能凭空生成路径。 - 两条
sdX都存在,multipath -ll只显示一条或没有映射:重点核对两条路径的 WWID、黑名单和find_multipaths等成图条件。 - 两条路径都在映射下,其中一条状态异常:先查该路径的链路与内核 I/O 错误,不要把“显示了路径”等同于“路径可用”。
- 路径健康,但映射名与预期不同:核对 WWID 与 alias 的对应关系,避免只按映射名判断成图失败。
例如,预期两个独立存储通道、同一 WWID 下有两条路径,而输出只列出 /dev/sdb。下一步应先查 /dev/sdc 是否被内核发现、其 WWID 是否相同,而不是立即对 /dev/sdb 执行重扫或删除。
从内核设备查到实际链路
核对每条路径是否指向同一个 LUN
对已在 lsblk 中出现的路径分别查询 udev 属性。以下设备名仅为示例,执行前应替换为现场确认的名称:

udevadm info --query=property --name=/dev/sdb | grep -E '^(ID_WWN|ID_SERIAL|ID_PATH)='
udevadm info --query=property --name=/dev/sdc | grep -E '^(ID_WWN|ID_SERIAL|ID_PATH)='
两条预期路径应能对应到同一个存储 LUN 标识,且传输路径信息有所区别。ID_WWN、ID_SERIAL 或 ID_PATH 是否提供、具体格式如何,取决于设备和 udev 规则;某个字段为空,不应单独作为 LUN 不同的证据。必要时结合存储侧的 LUN 标识,以及 multipathd show paths 中的 WWID 交叉核对。
如果 WWID 不同,先回到存储映射核对:它们可能是两个不同 LUN,不能通过配置强行合并。如果 WWID 相同、两块盘都存在,但仅一块进入映射,才继续查 multipath 的选择规则。
区分链路失联与路径被拒绝
对 FC 环境,可以先看主机端口状态及近期内核消息:
for p in /sys/class/fc_host/host*/port_state; do
[ -r "$p" ] && printf '%s: %s\n' "$p" "$(cat "$p")"
done
journalctl -k --since "30 minutes ago" --no-pager | grep -Ei 'scsi|fibre|fc|I/O error|timeout|reset'
对使用 iSCSI 且已安装相应工具的环境,可查看会话及其关联设备:
iscsiadm -m session -P 3
journalctl -k --since "30 minutes ago" --no-pager | grep -Ei 'iscsi|scsi|I/O error|timeout|reset'
这些命令用于观察,不会修复链路。FC 端口状态正常也不代表目标 LUN 一定已呈现;iSCSI 会话存在也不代表每个目标下的 LUN 都已被内核识别。应把主机输出与交换机端口、目标端口、存储映射记录对齐。
若日志持续出现超时、设备重置或 I/O 错误,且 multipath -ll 中对应路径为故障状态,优先处理物理或存储链路。若两块磁盘在内核层稳定存在、标识一致,日志也没有相应链路错误,却只有一条路径被 multipath 接纳,配置冲突的可能性更高。
重点检查:黑名单是否排除了目标 WWID
一种典型情况是:存储侧已呈现两条路径,内核也识别了设备,但旧的 multipath.conf 将目标 WWID 放入 blacklist。此时不断触发设备扫描并不能解决问题,因为 multipath 仍会按配置排除它。
先查看配置文件和当前可解析的配置。配置文件通常位于 /etc/multipath.conf,但实际生效项也可能包含发行版默认值、附加配置文件或设备专用规则,因此不能只搜索一个文件就下结论:
multipath -t
multipathd show config
multipath -t 用于查看命令端解析出的配置;multipathd show config 用于核对运行中的守护进程配置。检查输出中的 blacklist、blacklist_exceptions、multipaths、devices 和 find_multipaths。两者若不一致,要先确认是否修改过配置却尚未让守护进程重新加载,以及当前版本支持的配置加载方式。
还应查看相关日志中是否有排除或路径检查信息:
journalctl -u multipathd --since "30 minutes ago" --no-pager
在不确定排除原因时,可于维护排查期间使用较高详细级别的只读检查,但输出可能很长,应按目标 WWID 和设备名筛选、保存:
multipath -d -v3
这里 -d 表示不创建或更新映射的 dry run;仍应先用本机 multipath -h 核验参数是否受当前版本支持。不要把详细日志中的某一条提示脱离上下文解读:需要同时确认被排除的是目标路径、目标 WWID,还是一个无关设备。
黑名单尤其要分清匹配对象。下面是用于说明冲突的配置片段,WWID 为示例值:
blacklist {
wwid "3600508b400105e210000900000490000"
}
如果目标 LUN 的 WWID 正是这一值,那么该规则会阻止它进入多路径管理。修复通常是移除这条已确认误加的 WWID 规则,保留其他必要的排除项;不要为了一个 LUN 把整个黑名单清空。若计划使用 blacklist_exceptions,还要确认例外项与实际黑名单项的匹配类型和配置行为,不能认为添加一条 WWID 例外就一定能覆盖另一条按设备名匹配的排除规则。
黑名单未命中时,看成图条件和映射关系
如果目标设备未被排除,下一步是判断 multipath 为什么没有把它建成预期映射。
首先查看 multipath -t 中的 find_multipaths 设置。启用该机制后,是否为某个 WWID 建图与已发现的路径数、已有 WWID 记录及所用模式有关;具体行为应以当前版本配置为准。若现场实际只发现一条路径,而配置又要求满足相应成图条件,“没有映射”可能是预期行为。此时先解决第二条路径未出现的问题,不宜直接关闭该机制,让单一路径设备也被批量纳入管理。
其次检查 WWID 与 alias。/dev/mapper/ 下的名字是访问入口,识别同一个 LUN 应以 WWID 为核心。可对目标映射核对:

multipath -ll
udevadm info --query=property --name=/dev/mapper/data_lun | grep -E '^(DM_NAME|DM_UUID)='
readlink -f /dev/mapper/data_lun
命令中的 data_lun 应替换为现场映射名。如果 readlink 指向某个 /dev/dm-X,可进一步查看它当前关联的底层设备:
ls -l /sys/block/dm-X/slaves/
这里的 dm-X 必须替换为上一条命令实际得到的编号。若映射名变了但 WWID 和下层路径正确,问题更可能是 alias 配置或命名变化;在未核对文件系统、LVM 和应用引用路径前,不应删除映射重新创建。若 WWID 相同而 slaves 中缺少预期路径,则回到路径接纳状态与链路状态继续查。
按结果修复,并验证 I/O 所用的映射
配置变更比查询命令风险高。修改前应确认目标 WWID、业务使用的映射、当前冗余路径和维护窗口;先备份原文件:
cp -a /etc/multipath.conf /etc/multipath.conf.bak.$(date +%Y%m%d%H%M%S)
仅在确认某条黑名单规则误排除目标 WWID 后,编辑 /etc/multipath.conf 中对应规则。不要顺手改动其他 LUN 的 blacklist、multipaths 或路径分组策略。保存后先检查配置能否被解析、目标排除项是否消失:
multipath -t
检查通过后,再按本机 multipath-tools 版本和变更窗口要求,让运行中的守护进程重新加载配置。常见环境可使用:
multipathd reconfigure
multipathd show config
multipathd show paths
multipath -ll
reconfigure 可能影响该主机上不止一个映射的路径处理,生产环境应观察全部关键 LUN,而不是只看目标 LUN。若解析报错或重载后出现非预期路径变化,停止继续操作,使用备份文件恢复原配置,再重新检查配置并按相同方式重载;若已影响正在使用的映射,应结合业务和存储侧状态制定恢复动作,不能把“恢复文件”视为 I/O 已自动恢复。
验收至少包含三层:multipath -ll 下目标 WWID、路径数和路径状态符合预期;lsblk 与 /sys/block/dm-X/slaves/ 显示的下层设备对应正确;业务实际使用的文件系统或 LVM 仍指向预期映射,近期日志没有新的超时与 I/O 错误。两条路径“显示出来”不等于两条路径都健康,也不等于业务已经使用该映射。

如果根因是链路失联,应先由对应团队恢复端口、会话或存储呈现,再复查内核设备和 multipath 状态;不要在业务运行中用 multipath -F、删除 sdX、退出存储会话等动作试探。恢复后持续观察一个业务高峰或既定观察窗口,记录路径是否再次抖动、故障路径是否反复切换,以及是否出现新的 I/O 错误。这样才能确认修复的是配置冲突或链路故障本身,而不只是暂时让路径重新出现在命令输出中。
围绕 Linux 主机上的数据库、文件服务及大容量数据业务,A5数据提供香港、美国、日本等地区的物理服务器资源,覆盖常规计算、AMD EPYC、NVMe 和企业级机械硬盘等产品方向,可为高频数据访问、文件存储、备份归档及多任务运行提供相应的硬件基础,并结合不同地区与线路方案承载跨区域业务。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5360.html



