一键登录 更安全快捷
获取验证码
密码登录
验证码登录
登录
登录/注册
0
收藏
ESXi主机通过esxcli工具查询存储硬件适配器，通用查看所有存储适配器完整标准命令为 esxcli storage san adapter list，该命令会输出服务器全部vmhba存储适配器基础信息；针对FC光纤HBA卡、iSCSI软件适配器、NVMe适配器等细分存储硬件，可追加对应子指令单独筛选对应类型适配器，快速定位存储链路故障、硬件识别异常问题。
有VMware全系列产品官方资源和定制版资源需求的可以移步：
机房一台ESXi服务器光纤存储链路闪断，vCenter提示存储适配器硬件异常，需要登录ESXi SSH查看本机所有HBA存储适配器硬件状态、WWN号、驱动版本、链路速率。
1.1 初期命令使用误区
最开始只使用 esxcli storage san fc list 仅能查看FC光纤适配器，无法查询iSCSI、NVMe本地盘适配器，导致遗漏本机其他存储硬件信息，无法完整排查全量存储链路。
1.2 分层标准查询验证
执行通用全量查询命令 esxcli storage san adapter list 后，一次性输出本机所有vmhba适配器，包含FC光纤卡、iSCSI软件适配器、NVMe本地存储适配器全部硬件参数；根据故障类型搭配细分指令，单独筛选对应存储硬件，大幅提升存储故障定位效率。
1、通用全量查询：查看服务器所有类型存储适配器（推荐首选）
esxcli storage san adapter list
适用场景：需要完整盘点ESXi全部存储硬件，包含FC光纤HBA卡、硬件iSCSI卡、软件iSCSI适配器、NVMe本地盘适配器、SAS阵列卡适配器；输出字段包含适配器名称vmhba、硬件厂商、驱动版本、固件版本、WWN/iqn标识、链路状态。
2、细分类型1：单独查看FC光纤HBA适配器列表
esxcli storage san fc adapter list
适用场景：光纤存储、SAN阵列故障排查，仅筛选FC类型HBA卡，单独输出光纤适配器WWN、端口速率、光纤链路计数、端口在线/离线状态，快速定位光纤链路闪断、端口离线故障。
3、细分类型2：单独查看iSCSI存储适配器列表
esxcli storage san iscsi adapter list
适用场景：IP-SAN iSCSI存储排查，区分硬件iSCSI卡、ESXi内置软件iSCSI适配器，输出适配器IQN名称、绑定网卡、会话连接状态，排查iSCSI会话断开、存储挂载失败问题。
4、细分类型3：单独查看NVMe本地存储适配器列表
esxcli storage san nvme adapter list
适用场景：服务器NVMe闪存盘、本地NVMe存储排查，输出NVMe适配器型号、固件、命名空间状态，用于本地高速存储硬件识别、磁盘故障排查。
1、查看适配器对应物理硬件PCI地址
vmkchdev -l | grep vmhba
可匹配vmhba适配器与服务器PCI插槽位置，定位机箱内对应硬件插槽，方便机房硬件更换、HBA卡故障替换。
2、查看HBA光纤适配器详细链路统计、错误计数
esxcli storage san fc stats get -a vmhbaX
替换vmhbaX为目标适配器名称，查看光纤端口收发包、CRC错误、信号丢失计数，用于定位光纤线、光模块、交换机端口硬件故障。
3、查看iSCSI适配器会话连接详情
esxcli storage san iscsi session list
列出所有iSCSI存储目标会话、登录状态、目标IP，排查iSCSI存储断开、重连失败问题。
| 故障现象 | 根因分析 | 标准解决方案 |
|---|---|---|
| 仅执行fc list命令，无法查看iSCSI/NVMe存储适配器，存储硬件排查不全 | fc子命令仅筛选光纤HBA卡，不包含iSCSI、NVMe、SAS适配器，无法展示全量存储硬件 | 优先使用通用全量查询命令 esxcli storage san adapter list 查看服务器所有存储适配器，再按需细分筛选 |
| 执行adapter list查看到vmhba适配器，但vCenter识别不到存储磁盘 | 适配器硬件在线，但存储阵列LUN未映射、光纤交换机分区Zoning配置缺失 | 查询适配器WWN，核对存储阵列LUN映射、光纤交换机Zoning配置，重新扫描存储设备 |
| 光纤存储链路频繁闪断，需要查看HBA端口错误包统计 | 光纤线、光模块、存储交换机端口硬件故障，产生大量CRC错误、丢包 | 使用 esxcli storage san fc stats get -a vmhbaX 查看端口错误计数，更换光纤/光模块、排查交换机端口 |
| iSCSI存储会话频繁断开，需要确认iSCSI适配器与目标会话状态 | 软件iSCSI适配器网卡负载过高、存储目标IP网络不通、会话超时配置不合理 | 执行 esxcli storage san iscsi adapter list 确认适配器状态，查看iscsi session list会话连接，排查存储网络链路 |
| 本地NVMe磁盘无法被ESXi识别，需要查询NVMe适配器硬件状态 | NVMe适配器固件版本过低、PCI插槽硬件故障，适配器未正常初始化 | 使用 esxcli storage san nvme adapter list 查看NVMe适配器，升级硬件固件、更换服务器PCI插槽重试 |
1. 误区：查询服务器所有存储适配器直接使用fc list命令即可，能展示全部存储硬件纠正：esxcli storage san fc adapter list 仅筛选FC光纤HBA卡，iSCSI软件适配器、NVMe本地盘、SAS阵列卡适配器不会输出；完整查看所有存储适配器必须使用通用命令 esxcli storage san adapter list。
2. 误区：esxcli查询到vmhba适配器在线，存储磁盘就一定能正常挂载识别纠正：适配器硬件在线仅代表HBA卡本身硬件正常，光纤交换机Zoning、存储阵列LUN映射、iSCSI目标权限等上层配置缺失，依旧无法识别存储磁盘，需配套核查存储网络与阵列配置。
3. 误区：iSCSI存储故障直接执行fc适配器查询命令就能定位问题纠正：fc系列命令仅针对光纤SAN硬件，IP-SAN iSCSI存储硬件需要使用iscsi子命令单独查询，混用命令无法获取iSCSI适配器、会话连接信息。
4. 误区：esxcli只能查看存储适配器基础信息，无法查看端口错误、收发包统计纠正：esxcli配套stats统计子命令，可单独查询指定vmhba适配器的端口流量、错误数据包、信号丢失计数，是排查光纤链路硬件故障的核心工具。
5. 误区：NVMe本地闪存盘不属于san存储适配器，无法通过esxcli san命令查询纠正：ESXi将NVMe本地存储纳入san存储管理体系，esxcli storage san nvme adapter list 可完整查询NVMe适配器硬件、固件、命名空间状态，本地高速存储故障排查可直接使用。
存储硬件巡检规范：机房定期巡检ESXi存储硬件时，统一优先执行 esxcli storage san adapter list 全量查询所有vmhba适配器，完整盘点FC、iSCSI、NVMe各类存储硬件状态，不单独使用fc/iscsi细分命令遗漏硬件。
故障分层排查规范：存储磁盘识别异常、链路闪断故障固定排查流程：全量查询所有存储适配器确认硬件在线→按存储类型使用fc/iscsi/nvme细分命令定位对应适配器→执行stats统计查看端口错误计数→核查存储阵列、光纤交换机、存储网络上层配置。
硬件更换操作规范：更换HBA光纤卡、NVMe闪存盘前，通过vmkchdev -l | grep vmhba 匹配适配器PCI插槽位置，精准定位服务器机箱硬件插槽，减少机房硬件排查耗时。
存储类型命令区分规范：光纤SAN存储故障使用fc系列子命令，IP-SAN iSCSI存储使用iscsi系列子命令，本地NVMe高速存储使用nvme子命令，通用全量盘点统一使用adapter list基础命令。
批量主机巡检规范：多台ESXi集群批量巡检存储适配器，可通过PowerCLI远程调用esxcli命令批量导出所有主机存储适配器清单，统一归档硬件型号、固件、WWN信息，建立机房存储硬件台账。
