如何使用MongoDB Java Driver直接在Android端连接MongoDB Atlas？

算力阿峰

2026-10-4

报错根因

标准MongoDB Java Driver依赖JDK提供的javax.naming.directory.InitialDirContext类实现mongodb+srv前缀连接串的DNS解析逻辑，而Android运行时未内置该J2EE相关类，因此代码仅能在桌面JVM环境正常运行，迁移到Android后会抛出类不存在异常。

不使用MongoDB Realm的可行方案

方案1：使用MongoDB Atlas Data API（推荐）

Atlas集群自带无需驱动即可调用的Data API，无任何兼容问题，操作步骤：

在Atlas控制台对应集群的Data API页面开启服务，获取API密钥与请求端点
使用Android自带的HTTP请求工具（如OkHttp、HttpURLConnection）按照接口规范构造增删改查请求即可，无需引入任何MongoDB相关依赖，完全规避类兼容问题。

方案2：使用Android适配版驱动+非SRV连接串

如果需要使用驱动方式操作数据库，按照以下步骤修改：

替换驱动依赖：不要使用标准的MongoDB Java Driver，改用官方适配Android的专属驱动版本，在模块级build.gradle中添加依赖：

dependencies {
    implementation 'org.mongodb:mongodb-driver-android:3.12.14'
}

注意：4.x及以上版本的标准MongoDB Java Driver已停止对Android的支持，不要引入高版本标准驱动，否则仍会出现类缺失问题。

替换连接串格式：在Atlas控制台连接页面选择「Connect your application」，将驱动版本选择为3.4及更早，获取不带mongodb+srv前缀的标准连接串，避免触发依赖javax.naming的DNS解析逻辑。
子线程执行数据库操作：Android系统禁止在主线程执行网络请求，你当前写在onCreate中的数据库操作逻辑即使解决类缺失问题，也会触发主线程网络异常，需要将数据库操作逻辑放到子线程（如Thread、Kotlin协程）中执行。