故障排除

Chrome 阻止了本地网络访问

droid.devpier.dev 上的页面会连接到你自己 Mac 上的网关。Chrome 在首次连接时会请求权限。如果你拒绝了，页面无法连接，在几次失败尝试后，它会告知你 Chrome 阻止了对你 Mac 的访问。

重新允许的方法：

1. 打开 Chrome 设置 → 隐私和安全 → 网站设置。
2. 找到 droid.devpier.dev，允许本地网络访问。
3. 重新加载页面。

如果仍然无法连接，请使用本地备用页面。

端口已被占用

网关默认监听端口 7300。如果另一个程序已使用该端口，网关无法在此端口启动。查找该程序：

lsof -nP -iTCP:7300 -sTCP:LISTEN

停止该程序，或在其他端口启动网关：

android-emu-web --port 7301

网关会将新端口写入它打开的地址，页面会连接到正确的端口。

未找到模拟器

如果页面提示未找到正在运行的模拟器：

• 检查模拟器是否在运行：adb devices 应该列出 emulator-5554 或类似内容。
• 检查它是否在启用 gRPC 的情况下启动（-grpc <port>）。网关无法读取未启用 gRPC 的模拟器的画面。

你也可以从页面的列表中启动设备。请参阅设备。

未找到模拟器时，网关会继续运行并在终端中打印原因。

如果网关报告 Android SDK、emulator、platform-tools 或系统镜像缺失，请按照它打印的修复方法操作。请参阅首次运行。

“sdkmanager” 缺失

Android Studio 安装的 SDK 可能不包含 cmdline-tools（提供 sdkmanager 和 avdmanager）。网关不会下载它。请从 developer.android.com 下载 Google 命令行工具并解压，确保以下路径存在：

<your SDK>/cmdline-tools/latest/bin/sdkmanager

令牌已过期

网关每次启动时都会创建新令牌。如果你重启了网关，仍持有旧令牌的页面会显示令牌已失效并停止重试。请打开网关打印的新链接，或重新运行网关。

页面提示网关或页面已过期

• 网关已过期： 运行页面显示的升级命令。与安装命令相同。
• 页面已过期： 用 Cmd+Shift+R 强制刷新页面。

浏览器不正确

该页面仅在 Chrome 和 Edge 中有效。在其他浏览器中，它会要求你切换，并不会尝试连接。请参阅浏览器支持。

使用本地备用页面

网关在 http://127.0.0.1:7300/app/（或你选择的端口）上提供相同的页面。当公共页面无法加载或本地网络访问被拒绝时，可使用此页面。

画面停止更新

如果模拟器退出或重启，页面会显示已断开连接。网关继续运行。当模拟器恢复后，页面会重新连接，画面也会恢复。