Ionic Capacitor Community Http原生模块在Android设备/模拟器无法运行

问题场景 #

使用@capacitor-community/http模块进行Ionic Capacitor原生HTTP请求，按官方文档调用get方法，但在Android模拟器及真机上均触发以下错误：

java.lang.NullPointerException: Attempt to invoke virtual method 'java.util.Iterator com.getcapacitor.JSObject.keys() on a null object reference

错误堆栈详情：

result Http.get ERROR Error: NullPointerException at returnResult at win.androidBridge.onmessage

当前依赖版本：

• @capacitor/android: "5.0.4"
• @capacitor/app: "5.0.2"
• @capacitor/core: "5.0.4"

解决方案 #

1. 确保请求参数无null值 #

插件Android端在解析headers、params等对象参数时，若传入null会触发空指针异常。调用Http.get()时，需保证所有对象类型的参数初始化为空对象而非null：

import { Http } from '@capacitor-community/http';

// 正确示例：初始化所有对象类型参数
const response = await Http.get({
  url: 'https://your-api-domain.com/path',
  headers: {}, // 禁止设为null
  params: {}   // 禁止设为null
});

2. 同步插件与Capacitor核心版本 #

@capacitor-community/http需与Capacitor核心版本适配，当前使用Capacitor 5.x，需确保插件版本为5.x兼容版：

# 更新插件到适配Capacitor 5.x的最新版本
npm install @capacitor-community/http@latest

# 同步Android项目配置
npx cap sync android

3. 清理Android构建缓存 #

缓存可能导致代码不兼容，执行以下步骤清理重建：

# 进入Android项目目录
cd android

# 清理构建缓存
./gradlew clean

# 重新构建项目
./gradlew build

# 回到根目录同步Capacitor配置
cd ..
npx cap sync android

4. 确认网络权限配置 #

检查android/app/src/main/AndroidManifest.xml中是否已添加网络权限（Capacitor默认会自动添加，但若手动修改过需确认）：

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

错误原因说明 #

该空指针异常通常由两种情况导致：一是请求参数中headers/params等字段被设为null，Android端代码尝试调用keys()方法时触发；二是插件版本与Capacitor核心版本不匹配，导致参数解析逻辑出现兼容性问题。

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