Android端连接MongoDB数据库出现MongoTimeoutException超时错误如何解决

1 先修复MongoDB服务端配置（最常见根因） #

• 找到你电脑上MongoDB的配置文件（默认是mongod.cfg），检查bindIp配置项：默认值为127.0.0.1，代表仅允许本机访问，模拟器属于外部设备，自然无法连接。测试阶段可以修改为0.0.0.0，或者同时绑定127.0.0.1和你电脑的物理网卡IP，修改完成后重启MongoDB服务生效。
• 确认电脑防火墙放通27017端口，测试阶段可以暂时关闭防火墙验证是否是拦截导致的连接失败。

2 修正Android端配置 #

• 代码里的MongoDB连接串统一替换为mongodb://10.0.2.2:27017，这个地址是Android模拟器预留的指向宿主电脑的专属地址，不要用localhost。
• 检查AndroidManifest.xml是否添加了必要的网络权限，没有的话补充以下配置：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

• 如果你的测试设备Android版本在9（API 28）及以上，系统默认禁止明文流量请求，需要在AndroidManifest.xml的application标签中添加android:usesCleartextTraffic="true"配置，或者给MongoDB配置TLS加密访问。

3 解决修改10.0.2.2后模拟器WIFI异常问题 #

该问题和MongoDB连接没有关联，属于模拟器快照缓存导致的异常：

• 打开AVD管理器，选中当前使用的模拟器，点击右侧下拉菜单选择「Cold Boot Now」执行冷启动，不要使用快速启动的快照。
• 如果冷启动后WIFI仍然异常，直接删除当前模拟器重新创建即可，创建时网络配置保持默认NAT即可，不需要手动修改IP、DNS参数。

额外提醒 #

直连MongoDB仅适合本地测试使用，生产环境绝对不要用这种方案：数据库连接凭证会直接打包在APK中容易被反编译泄露，直接暴露数据库端口也有极高的安全风险，生产环境必须加后端服务层做接口转发。
测试时可以先打开模拟器自带的浏览器，访问http://10.0.2.2:27017，如果能看到MongoDB的默认提示页，就说明模拟器到宿主电脑的网络是通的，问题仅出在代码或者MongoDB权限配置上。

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