前言

JX-A7T 系列模块作为支持离线指令与在线 AI 大模型的双模语音模组，其 WiFi 配网功能是实现在线功能的关键步骤。然而，许多开发者在初次使用智能公元小程序进行配网时，会遇到 WiFi 列表一直显示"正在获取 WiFi 列表"的问题。

本文基于真实用户案例（智能公元技术交流群，2026-03-04），系统讲解此问题的原因分析和完整解决方案，涵盖配网原理、操作流程、常见问题排查以及配网后的验证步骤。

问题现象描述

典型问题表现

用户在使用智能公元小程序对 JX-A7T 模块进行 WiFi 配网时，出现以下现象：

1. 小程序进入配网页面后，WiFi 列表区域一直显示"正在获取 WiFi 列表"
2. 等待较长时间后，列表仍然为空或无变化
3. 模块已处于 WiFi 档位，蓝色指示灯正常闪烁（表示已进入配网模式）
4. 手机已连接移动数据网络

真实用户案例

用户提问（智能公元3群，2026-03-04）： "JX-A7T1启动后，通过小程序配网扫描的WiFi列表，一直显示正在获取WiFi列表，这个咋处理"

技术支持解答： "打开WIFI了吗？获取WIFI列表是获取你手机当前可搜索到的WIFI，这个是需要打开的"

用户常见误区

遇到此问题时，用户通常会尝试以下方法，但往往无效：

• 反复重启模块
• 重新烧录固件
• 更换配网页面入口
• 检查模块是否损坏

这些操作实际上与问题根源无关。

根本原因分析

小程序获取 WiFi 列表的原理

要理解这个问题，首先需要了解小程序配网时 WiFi 列表的来源：

关键点：小程序配网时显示的 WiFi 列表，来源于手机自身 WiFi 模块扫描到的网络，而非 JX-A7T 模块扫描的结果。

这意味着：

• 小程序通过调用微信的 WiFi API 获取手机当前可搜索到的 WiFi 网络列表
• 模块本身不进行 WiFi 扫描
• 列表的显示完全依赖于手机的 WiFi 功能状态

为什么会一直显示"正在获取"？

当小程序一直显示"正在获取 WiFi 列表"时，最常见的原因是：

手机的 WiFi 功能未开启

虽然手机可能连接着移动数据网络，但 WiFi 开关可能处于关闭状态。没有开启 WiFi，小程序就无法调用系统 API 获取附近的 WiFi 列表。

另一个常见误区：使用手机热点配网

许多用户希望使用手机热点进行配网，但遇到了问题：

• 用户用手机 A 开启热点
• 同时在手机 A 上运行智能公元小程序进行配网
• 结果发现 WiFi 列表中没有看到自己开启的热点

原因：同一台手机无法同时作为热点设备和 WiFi 扫描设备

这是系统的硬件限制，不是模块或小程序的问题。手机开启热点后，其 WiFi 模块工作在 AP 模式，无法同时工作在 Station 模式去扫描其他网络，包括它自己开启的热点。

完整解决方案

方案一：开启手机 WiFi（最常见问题的解决）

适用场景： 使用路由器或其他已有的 WiFi 网络进行配网

操作步骤：

1. 开启手机 WiFi

• 进入手机设置
• 找到 WiFi 设置
• 确保 WiFi 开关处于"开启"状态

1. 确认 WiFi 可用

• 手机可以连接到目标 WiFi 网络
• 信号强度良好（建议两格以上）

1. 重新进入小程序配网页面

• 返回小程序首页
• 重新进入设备配网页面
• 此时 WiFi 列表应该能正常显示

方案二：使用两部手机进行热点配网

适用场景： 需要使用手机热点进行配网，且只有一台手机时

操作步骤：

1. 准备两部手机

• 手机 A：开启热点，作为目标网络
• 手机 B：运行智能公元小程序，进行配网操作

1. 手机 A 设置

• 进入设置 → 个人热点 → 开启
• 记录热点名称和密码
• 建议使用 2.4GHz 频段（JX-A7T 仅支持 2.4G WiFi）

1. 手机 B 操作

• 确保手机 B 的 WiFi 已开启
• 打开智能公元小程序
• 进入配网页面，搜索 WiFi
• 在列表中找到手机 A 的热点并连接

方案三：使用其他设备开启热点

适用场景： 没有两部手机，但有其他可联网设备

可用设备：

• 平板电脑
• 笔记本电脑的热点
• 便携式 WiFi 设备
• 其他手机

操作步骤与方案二类似

方案四：使用路由器网络（推荐）

适用场景： 有可用的 WiFi 路由器

操作步骤：

1. 准备路由器网络

• 确保 2.4GHz WiFi 已开启
• 记录 WiFi 名称和密码

1. 手机连接路由器 WiFi

• 确保手机 WiFi 已开启
• 连接到目标路由器

1. 小程序配网

• 进入配网页面
• 选择路由器 WiFi 进行配置

WiFi 配网完整操作流程

为了确保配网成功，建议按照以下完整流程操作：

第一步：模块准备

1. 档位设置

• 将 JX-A7T 模块拨到 WiFi 档位
• 按下复位按钮重启模块
• 确认蓝色指示灯闪烁（表示已进入配网模式）

第二步：手机准备

1. 检查 WiFi 状态

• 确保手机 WiFi 已开启
• 如果使用热点，确保用另一设备开启

1. 打开小程序

• 微信搜索"智能公元"
• 登录账号

第三步：配网操作

1. 添加设备

• 点击"+"号
• 选择蓝牙连接方式
• 授权小程序使用蓝牙（初次需要）

1. 搜索并连接模块

• 选择 JX-A7T 设备
• 等待蓝牙连接成功

1. 配置 WiFi

• 在 WiFi 列表中选择目标网络
• 输入密码
• 等待配置完成

第四步：验证连接

1. 观察模块指示灯

• 蓝灯常亮表示已连接成功

1. 测试在线功能

• 尝试唤醒并使用 AI 对话功能
• 确认网络通信正常

常见问题排查

问题 1：WiFi 开启后仍无法获取列表

可能原因：

• 微信小程序权限问题
• 手机系统限制

解决方案：

1. 检查微信的 WiFi 权限是否开启
2. 部分手机需要同时开启位置权限
3. 尝试重启手机
4. 更新微信到最新版本

问题 2：WiFi 列表有网络但连接失败

可能原因：

• 仅支持 5GHz 频段
• 密码错误
• 信号太弱

解决方案：

1. 确认路由器开启了 2.4GHz 频段
2. JX-A7T 仅支持 2.4G WiFi，不支持 5G
3. 重新输入密码确认
4. 将模块移近路由器

问题 3：配网成功后无法使用在线功能

可能原因：

• 智能体未正确配置
• 智能体未上线

解决方案：

1. 确认在智能体平台已正确配置对话流/工作流
2. 仅配置"单 Agent 模式"无法通过语音触发
3. 确认小程序已成功绑定智能体
4. 检查智能体状态是否显示"在线"

技术原理说明

小程序配网架构

┌─────────┐         ┌─────────────┐         ┌──────────┐
│  手机   │ ──────> │  微信服务器 │ ──────> │ 云平台   │
│ (小程序) │  蓝牙   │             │  MQTT   │          │
└─────────┘         └─────────────┘         └──────────┘
     │                                           │
     │ WiFi列表                                 │ 配网信息
     │ (来自手机WiFi扫描)                         │
     ↓                                           ↓
  手机WiFi模块                               JX-A7T模块

数据流说明

1. 蓝牙阶段：小程序通过蓝牙连接 JX-A7T 模块
2. WiFi 配置：将 WiFi 信息通过蓝牙发送给模块
3. 模块连接：模块使用收到的 WiFi 信息连接路由器
4. 云端通信：连接成功后，模块通过 MQTT 与云平台通信

为什么不能用自己的热点？

┌─────────────────────────────────────────────────┐
│              单个手机 WiFi 模块                  │
│                                                 │
│   AP 模式（热点）  │  Station 模式（扫描）       │
│       ❌          │         ❌                 │
│                                                 │
│   同一硬件无法同时工作在两种模式                  │
└─────────────────────────────────────────────────┘

配网检查清单

在遇到配网问题时，可按此清单逐一排查：

• 手机 WiFi 已开启
• 微信小程序有 WiFi 和位置权限
• 模块处于 WiFi 档位
• 模块已复位，蓝灯闪烁
• 目标网络是 2.4GHz 频段
• 不是用同一手机开热点和配网
• 微信版本已更新
• 小程序版本已更新

总结

JX-A7T 小程序配网时 WiFi 列表显示"正在获取"的问题，其根本原因通常是 手机 WiFi 功能未开启。理解小程序获取 WiFi 列表的原理——即列表来源于手机 WiFi 扫描，不是模块扫描——是解决问题的关键。

核心要点：

1. 小程序显示的 WiFi 列表来自手机 WiFi 扫描，不是模块扫描
2. 同一手机无法同时作为热点和扫描设备
3. JX-A7T 仅支持 2.4GHz WiFi 网络
4. 遇到问题时优先检查手机 WiFi 开关状态
5. 推荐使用路由器网络进行配网，最稳定可靠

配网成功后，模块将记住网络信息，下次通电会自动连接，无需重复配网。

参考资源

• JX-A7T 产品文档： https://help.aimachip.com/docs/jxa7t_v1
• 小程序操作指南：智能公元平台文档中心
• SmartPi 官方文档 - JX-A7T 硬件设计 FAQ

关键词：JX-A7T、WiFi配网、小程序、获取WiFi列表、配网问题、热点配网、2.4GHz、配网流程

适用模块：JX-A7T、JX-A7T1、JX-A7T2 等支持 WiFi 的离在线混合语音模组