故障排查总表：按症状速查
第一步：快速自检清单（逐条勾）
PlainApp 官方排查指南里这 6 条覆盖了 90% 的问题，先全部走完再深入：
- ✅ PlainApp 在手机上点了 Start 吗？界面上能看到 IP:端口 吗？
- ✅ 手机自己浏览器打开那个 IP:端口，能访问吗？（手机自己都打不开 = 服务端问题）
- ✅ 手机和电脑在完全同一个 Wi-Fi（手机没开移动数据、电脑没连另一个 Wi-Fi、两边都没挂 VPN）
- ✅ 电脑浏览器精确复制手机上显示的地址（包括端口号、http vs https）
- ✅ 浏览器显示"连接不安全" → 点 高级 → 继续前往（不是 bug，是自签名证书警告）
- ✅ PlainApp 后台服务没被手机杀（通知栏能看到 PlainApp 的 START_STICKY 通知）
如果这 6 条都过了还打不开 → 跳到下面的症状对照表。
症状对照表
【最常见】浏览器完全打不开页面（超时或连接被拒）
→ 直接看 ping 测试
# Windows Command Prompt
ping 192.168.x.x # 换成手机上显示的那个 IP| ping 结果 | 诊断 | 解决方案 |
|---|---|---|
| 有回复（64 bytes from ...） | 网络通，但可能是浏览器 / 端口问题 | 换浏览器试、确认端口号（8080 / 8443 都试）、清除浏览器缓存 |
| Request timeout 无回复 | 电脑和手机根本不在一个网络里 | 检查两边 Wi-Fi 名称、确认手机没开移动数据、确认两边没挂 VPN |
浏览器显示"连接不安全"警告
→ 正常行为，不是 bug
| 浏览器 | 操作 |
|---|---|
| Chrome / Brave | 高级 → 继续前往（不安全） |
| Firefox | 高级 → 接受风险并继续 |
| Safari | 显示详细信息 → 访问此网站 |
打开了但页面一片空白或 404
- 确认地址里有没有端口号（
8080或8443——漏掉端口直接打不开任何东西） - 刷新（Ctrl+R / Cmd+R）或强制刷新（Ctrl+Shift+R）
- 换端口（http://8080 和 https://8443 都试试）
SMS 面板空、点发送没反应
→ 大概率是 Google Play 版
Google Play 版 PlainApp 因商店策略阉割了 SMS、App Manager、Notification Mirroring 三个核心功能。换 GitHub 直装版。
屏幕镜像点 Start 后黑屏 / 不动
- 手机上点 Start 后应该弹出"是否允许屏幕录制" — 点允许，不然没画面
- 画面出现后卡住不动 — 工具栏点 Relaunch（重启手机端镜像服务）
- 画质差 / 延迟高 — 工具栏切 Smooth 模式、确认手机电脑在 5 GHz Wi-Fi
通知镜像面板空
→ 大概率是 Notification Listener 权限没开
手机设置 → 安全 → 通知使用权 → PlainApp → 允许。授权后重启 PlainApp。
拖拽上传没反应
- 先确认 Files 页面是当前聚焦标签（点击标签页让它在最前）
- 非 Chrome / Brave 浏览器有时会静默忽略拖拽
- 换个浏览器试试
手机 IP 变了，书签地址失效
DHCP 会给手机动态分配 IP，重启路由或手机 Wi-Fi 重连时 IP 可能变。不要把书签写死 IP：
- 每次打开 PlainApp、点 Start，看手机界面显示的地址，手动输浏览器
- 或配置路由器给手机 固定 IP（静态 DHCP 租约）
VPN 开着时无法访问
VPN 会劫持所有网络请求，导致浏览器发往手机局域网 IP 的请求被送到 VPN 隧道里去了，根本到不了手机。
解决方案：
- 关掉 VPN再访问 PlainApp（最简单）
- 或在 VPN 客户端里设置 Split Tunnel——让
192.168.x.0/24走本地网卡不走 VPN
Router AP Isolation
很多公共 Wi-Fi（酒店、咖啡馆）和家用路由器默认开了 AP Isolation（AP 隔离）——同一 Wi-Fi 下的设备互相不能通信。
- 家庭路由器：登录管理后台找 "AP Isolation" / "Client Isolation" / "访客隔离" 关掉
- 公共 Wi-Fi：没办法，用手机开热点给电脑连（手机自己必须有移动数据）
还不行？
按顺序试：
- PlainApp 手机端 Stop → 重新 Start（重启服务）
- 重启 Wi-Fi 路由器
- 手机切换飞行模式再切回来（重新获取 DHCP）
- 电脑换个浏览器试
- PlainApp 手机端设置里 Clear App Data（会删所有已保存配置，慎用）
- 卸载重装 PlainApp
- GitHub Issues 搜同类问题（plainhub/plain-app → Issues）