Flutter Android环境下ObjectBox Admin配置失败求助

1. 修正服务器绑定地址 #

模拟器内的127.0.0.1是自身回环地址，无法被外部（包括宿主机器）访问。检查启动Admin的代码，将绑定地址改为0.0.0.0，让服务监听所有可用网络接口：

final admin = Admin(store, bindAddress: '0.0.0.0');

2. 使用正确的访问地址 #

• 宿主机器浏览器尝试访问 http://10.0.2.2:8090（Android模拟器默认的宿主映射地址），而非127.0.0.1:8090
• 模拟器内浏览器可尝试访问 http://localhost:8090 或 http://10.0.2.2:8090

3. 检查端口占用与监听状态 #

• 宿主机器执行命令排查端口占用：
  Windows：netstat -ano | findstr :8090
  Mac/Linux：lsof -i :8090
• 模拟器内执行 adb shell netstat | grep 8090，确认ObjectBox Admin确实在监听该端口

4. 核对配置文件有效性 #

pubspec.yaml 检查项 #

确保依赖版本兼容：

dependencies:
  objectbox: ^x.x.x
  objectbox_admin: ^x.x.x # 版本需与objectbox主库匹配
dev_dependencies:
  objectbox_generator: ^x.x.x
  build_runner: ^x.x.x

build.gradle.kts 检查项 #

确认app模块配置正确：

android {
    defaultConfig {
        buildConfigField("boolean", "OBJECTBOX_ADMIN", "true")
    }
}

dependencies {
    implementation("io.objectbox:objectbox-android-admin:x.x.x")
}

5. 重置服务与模拟器 #

• 完全终止Flutter应用进程，重启模拟器
• 重新执行 adb forward tcp:8090 tcp:8090，确保转发规则重新生效

6. 排查防火墙限制 #

• 检查宿主机器防火墙是否允许8090端口的入站/出站请求
• 确认模拟器内无安全策略限制本地端口访问

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