树莓派3B使用NMCLI配置AP模式失败：无适配设备问题

问题场景 #

在Raspberry Pi 3 Model B Rev 1.2上，使用以下Bash脚本通过Network Manager配置AP模式，执行后激活连接失败。

配置脚本：

host="MyRPiAPMode"
sudo nmcli con add type wifi ifname wlan0 con-name $host autoconnect yes ssid $host
sudo nmcli con modify $host 802-11-wireless.mode ap 802-11-wireless.band bg ipv4.method shared
sudo nmcli con modify $host wifi-sec.key-mgmt wpa-psk
sudo nmcli con modify $host wifi-sec.psk "SomeRandomPassword"
sudo nmcli radio wifi on
sudo nmcli con up $host

报错信息 #

Connection 'MyRPiAPMode' (60965f2a-f510-48ef-afaf-0864242d0c06) successfully added.
Error: Connection activation failed: No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name)).

执行后相关输出 #

nmcli con 输出 #

NAME                UUID                                  TYPE      DEVICE 
Wired connection 1  9589ff1a-9923-3de3-a8a4-90b319661878  ethernet  eth0   
MyRPiAPMode         60965f2a-f510-48ef-afaf-0864242d0c06  wifi      --   

nmcli dev 输出 #

DEVICE  TYPE      STATE        CONNECTION         
eth0    ethernet  connected    Wired connection 1 
wlan0   wifi      unavailable  --                 
lo      loopback  unmanaged    -- 

系统日志片段 #

-- Journal begins at Sat 2021-08-07 09:28:21 IST. --
Aug 10 15:06:19 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124179.9816] audit: op="connection-update" uuid="60965f2a-f510-48ef-afaf-0864242d0c06" name="MyRPiAPMode" args="802-11-wireless-security.psk" pid=25120 uid=0 result="success"
Aug 10 15:06:20 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124180.0902] audit: op="radio-control" arg="wireless-enabled" pid=25125 uid=0 result="success"
Aug 10 15:06:21 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124181.4241] agent-manager: agent[641f99ab55d9691c,:1.692/nmcli-connect/0]: agent registered
Aug 10 15:06:21 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124181.4281] audit: op="connection-activate" uuid="60965f2a-f510-48ef-afaf-0864242d0c06" name="MyRPiAPMode" result="fail" reason="No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name))."
Aug 10 15:06:52 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124212.0573] agent-manager: agent[70ee130ba0f26cd7,:1.696/nmcli-connect/1000]: agent registered
Aug 10 15:06:52 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124212.0614] audit: op="connection-activate" uuid="60965f2a-f510-48ef-afaf-0864242d0c06" name="MyRPiAPMode" result="fail" reason="No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name))."
Aug 10 15:07:23 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124243.0370] agent-manager: agent[cc77ef461499c164,:1.700/nmcli-connect/0]: agent registered
Aug 10 15:07:23 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124243.0414] audit: op="connection-activate" uuid="60965f2a-f510-48ef-afaf-0864242d0c06" name="MyRPiAPMode" result="fail" reason="No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name))."
Aug 10 15:07:41 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124261.8406] agent-manager: agent[79b01af218789b42,:1.702/nmcli-connect/0]: agent registered
Aug 10 15:07:41 NWPI-b5b072 NetworkManager[16140]: <info>  [1660124261.8446] audit: op="connection-activate" uuid="60965f2a-f510-48ef-afaf-0864242d0c06" name="MyRPiAPMode" result="fail" reason="No suitable device found for this connection (device eth0 not available because profile is not compatible with device (mismatching interface name))."

问题根源与解决步骤 #

问题根源 #

从nmcli dev输出可见，wlan0处于unavailable状态是核心问题。Network Manager找不到可用的WiFi设备，只能尝试用eth0激活WiFi连接，最终导致不兼容报错。wlan0不可用的常见原因包括：WiFi模块被禁用、驱动未加载、Network Manager未获取设备控制权。

解决步骤 #

1. 解锁WiFi硬件
   执行命令解除可能的WiFi硬件锁定：

   sudo rfkill unblock wlan
   

2. 重启Network Manager服务
   让Network Manager重新识别WiFi设备：

   sudo systemctl restart NetworkManager
   

   执行后用nmcli dev检查，wlan0状态变为disconnected即为正常。

3. 删除无效连接并重新配置
   先删除之前创建的无效AP连接：

   sudo nmcli con delete MyRPiAPMode
   

   再重新运行原配置脚本，此时wlan0已可用，连接可正常激活。

4. 检查系统配置
   打开/boot/config.txt文件，确认没有dtoverlay=disable-wifi这类禁用WiFi的配置，若有则删除并重启树莓派。

5. 验证驱动加载
   检查WiFi驱动是否正常加载：

   lsmod | grep brcmfmac
   

   若无输出，重新安装内核与驱动：

   sudo apt reinstall raspberrypi-kernel raspberrypi-bootloader
   

内容的提问来源于stack exchange，提问作者rafi_tc