网络连接问题
文档版本：V1.0 | 适用系统：Android14 / Linux | 适用硬件：C-3576BQ V10 核心板 + M4-R2（ShimetaPi）底板 | 更新日期：2026-10-23
1. 概述
本文档汇总 M4-R2（RK3576）平台上 Android14 与 Linux 系统的网络连接常见问题与处理方法，涵盖有线以太网（双千兆 GMAC）、WiFi、蓝牙及通用网络配置问题。
2. 网络接口概述
M4-R2 底板网络接口（S-01 已验证）：
| 接口类型 | 规格 | 说明 |
|---|---|---|
| 有线以太网 | 双路千兆（GMAC0 / GMAC1） | 千兆以太网接口 |
| WiFi | WiFi5（802.11ac） | 2.4GHz / 5GHz |
| 蓝牙 | BT5.0 | 经典蓝牙 + BLE |
注意：M4-R2 提供双路千兆以太网（GMAC0/GMAC1），具体接口位置与网口编号以底板实物为准（S-01 已验证双路千兆能力）。
3. 常见问题与处理方法
3.1 有线以太网问题
| 现象 | 原因 | 处理方法 |
|---|---|---|
| 网卡接口不存在 | 驱动未加载 | 检查 ip link 输出，确认 GMAC 驱动加载（详见以太网GMAC驱动） |
| 网卡状态 DOWN | 未启用 | 执行 ip link set eth0 up 或通过 NetworkManager/netplan 配置 |
| 无法获取 IP | DHCP 配置问题 | 检查 DHCP 客户端配置与路由器 DHCP 服务 |
| 千兆协商失败 | 网线/接口问题 | 检查网线类别（Cat5e 及以上）、接口状态（ethtool eth0） |
| 网络丢包严重 | 网线/电磁干扰 | 更换网线，检查接口附近干扰源 |
| 双网口无法同时使用 | 路由/子网配置问题 | 检查两个网口的 IP 配置与路由表（ip route） |
3.2 WiFi 问题
| 现象 | 原因 | 处理方法 |
|---|---|---|
| WiFi 接口不存在 | 驱动未加载 | 检查 WiFi 驱动（详见WiFi-蓝牙驱动）与天线连接 |
| 扫描不到热点 | 频段/信道问题 | 确认路由器发射 2.4GHz/5GHz 频段，检查地区信道限制 |
| 连接失败 | 认证方式不匹配 | 确认 SSID/密码正确，检查加密方式（WPA2/WPA3）兼容性 |
| 连接后频繁掉线 | 信号弱/省电模式 | 靠近路由器，检查 WiFi 省电策略 |
| 5GHz 无法连接 | 信道/地区限制 | 调整路由器信道，确认固件支持该地区 5GHz 频段 |
| WiFi 速度慢 | 信号质量/带宽限制 | 检查信号强度（iw dev wlan0 link），调整路由器位置 |
3.3 蓝牙问题
| 现象 | 原因 | 处理方法 |
|---|---|---|
| 蓝牙服务无法启动 | 蓝牙驱动/固件问题 | 检查蓝牙驱动加载与固件（详见WiFi-蓝牙驱动） |
| 无法扫描到设备 | 蓝牙未开启/信号问题 | 确认蓝牙已开启（bluetoothctl power on），靠近目标设备 |
| 配对失败 | 配对模式/兼容性问题 | 确认目标设备进入配对模式，检查 PIN 码 |
| 连接后频繁断开 | 信号弱/协议问题 | 靠近设备，检查蓝牙协议栈版本兼容性 |
| BLE 广播无法发送 | 权限/配置问题 | 检查 BLE 广播配置与应用权限 |
3.4 通用网络问题
| 现象 | 原因 | 处理方法 |
|---|---|---|
| 无法 ping 通外网 | DNS/路由问题 | 检查 ping 8.8.8.8 与 ping www.baidu.com，排查 DNS 配置 |
| DNS 解析失败 | DNS 配置错误 | 检查 /etc/resolv.conf 或网络管理器 DNS 配置 |
| SSH 无法连接 | 服务未启动/防火墙 | 检查 sshd 服务状态与防火墙规则（详见网络配置与SSH） |
| 网络时通时断 | 网线松动/电源问题 | 检查网线连接与供电稳定性 |
| 无法访问外网 | 网关/代理问题 | 检查默认网关（ip route）与代理配置 |
| 网络速度远低于预期 | 链路协商/拥塞 | 检查链路协商速率，测试不同时间段与服务器 |
4. 常见排查命令
| 命令 | 用途 |
|---|---|
ip addr / ip link | 查看网络接口与 IP 配置 |
ip route | 查看路由表 |
ping <host> | 测试连通性 |
nslookup <domain> / dig | 测试 DNS 解析 |
ethtool eth0 | 查看有线网卡协商状态 |
iw dev wlan0 link | 查看 WiFi 连接状态 |
bluetoothctl | 蓝牙管理工具 |
ss -tunlp / netstat -tunlp | 查看监听端口与服务 |
tcpdump -i eth0 | 抓包分析（需 root） |
5. 常见问题
Q1: 有线网卡找不到接口？
- 执行
ip link查看是否存在以太网接口（eth0/eth1） - 执行
dmesg | grep gmac查看 GMAC 驱动加载日志 - 确认设备树中 GMAC 节点使能（
status = "okay"） - 检查 PHY 芯片供电与复位电路
Q2: 能 ping 通 IP 但无法解析域名？
- 检查 DNS 配置（
cat /etc/resolv.conf） - 检查默认网关（
ip route） - 测试
ping 8.8.8.8确认外网连通 - 检查 DNS 服务器可达性与配置
Q3: WiFi 连接后频繁掉线？
- 检查信号强度（
iw dev wlan0 link） - 靠近路由器测试稳定性
- 检查 WiFi 省电模式（禁用省电策略测试）
- 更新路由器固件或更换信道
Q4: 双千兆网口只有一个是通的？
- 确认两个网口均正确连接网线
- 检查两个网口的 IP 配置（避免同一网段冲突）
- 检查 PHY 芯片状态（
ethtool eth0 eth1） - 确认设备树中两个 GMAC 节点均使能
Q5: SSH 连接被拒绝？
- 确认 sshd 服务已启动（
systemctl status sshd） - 确认 IP 与端口正确（默认 22 端口）
- 检查防火墙规则（
ufw status/iptables -L） - 检查 SSH 配置文件
/etc/ssh/sshd_config
Q6: 蓝牙无法开机自动连接？
- 确认蓝牙服务开机自启（
systemctl status bluetooth） - 使用
bluetoothctl配置自动连接 - 检查配对设备是否已保存信任关系
6. 相关文档
| 文档 | 说明 |
|---|---|
| 网络配置与SSH | 网络配置与 SSH 连接方法 |
| 以太网GMAC驱动 | 千兆以太网驱动开发 |
| WiFi-蓝牙驱动 | WiFi/蓝牙驱动开发 |
| 网络编程与应用 | 网络应用开发 |
| 调试工具使用指南 | 网络调试工具使用 |
| 底板接口定义 | 底板网络接口定义 |
| 核心板参数 | 核心板网络能力（双千兆 GMAC） |