React Native集成Node.js服务器并导出APK时gradle依赖报错解决

问题背景 #

我正在开发React Native应用，需要嵌入Node.js服务器来使用ytdl-core这类Node.js专属库，目标是：

• 在RN应用中嵌入Node.js服务器
• 支持生产环境APK导出
• 正常使用ytdl-core等Node.js库

已基于nodejs-mobile-react-native完成基础配置，但构建Android应用时出现以下错误：

Failed to install the app. Command failed with exit code 1: gradlew.bat app:installDebug -PreactNativeDevServerPort=8081 
FAILURE: Build failed with an exception.

* What went wrong:
A problem occurred configuring project ':nodejs-mobile-react-native'.
> Could not resolve all dependencies for configuration ':nodejs-mobile-react-native:classpath'.
> Could not find com.android.tools.build:gradle:2.2.3.

错误原因 #

nodejs-mobile-react-native@0.8.1依赖的Gradle版本（2.2.3）过于老旧，当前Android SDK仓库已不再提供该版本的下载，导致依赖解析失败。

解决方案 #

1. 升级nodejs-mobile-react-native版本 #

弃用老旧的0.8.1版本，安装最新稳定版：

npm uninstall nodejs-mobile-react-native
npm install nodejs-mobile-react-native@latest

（当前最新稳定版已更新Gradle依赖至兼容现代Android环境的版本）

2. 修复Android配置冲突 #

（1）更新android/build.gradle的Gradle插件版本

确保项目根目录的android/build.gradle中，dependencies块的Gradle插件版本与nodejs-mobile-react-native兼容，例如：

buildscript {
    ext {
        buildToolsVersion = "33.0.0"
        minSdkVersion = 21
        compileSdkVersion = 33
        targetSdkVersion = 33
        gradleVersion = "7.4.2"
    }
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:${ext.gradleVersion}")
        classpath("com.facebook.react:react-native-gradle-plugin")
    }
}

（2）调整打包配置

原android/app/build.gradle中的packagingOptions可能导致冲突，可修改为：

android {
    packagingOptions {
        pickFirst '**/libc++_shared.so'
        // 若使用Hermes替代JSC，可保留exclude '**/libjsc.so'，否则移除
    }
}

（3）简化依赖声明

android/app/build.gradle的dependencies块保持简洁：

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation "com.facebook.react:react-native:+"
    implementation project(':nodejs-mobile-react-native')
    implementation 'com.facebook.react:hermes-android' // 可选，若使用Hermes
}

3. 调整Node.js端代码适配 #

（1）安装ytdl-core到Node.js项目

进入nodejs-assets/nodejs-project目录，执行：

npm install ytdl-core express

并更新该目录下的package.json：

{
  "dependencies": {
    "express": "^4.18.2",
    "ytdl-core": "^4.11.5",
    "rn-bridge": "^1.0.0"
  }
}

（2）修改Node.js服务器代码（main.js）

添加ytdl-core的使用示例，并确保与RN的通信正常：

const express = require('express');
const ytdl = require('ytdl-core');
const rn_bridge = require('rn-bridge');
const app = express();

app.use(express.json());

// 测试API
app.get('/api/test', (req, res) => {
  res.json({ message: 'Node server running' });
});

// ytdl-core示例接口
app.get('/api/download-video', async (req, res) => {
  try {
    const { url } = req.query;
    if (!ytdl.validateURL(url)) {
      return res.status(400).json({ error: 'Invalid YouTube URL' });
    }
    const info = await ytdl.getInfo(url);
    res.json({ title: info.videoDetails.title, formats: info.formats.slice(0,5) });
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

// 启动服务器（Android中优先使用127.0.0.1而非localhost）
const PORT = 3000;
app.listen(PORT, '127.0.0.1', () => {
  rn_bridge.channel.send(`Node server started on http://127.0.0.1:${PORT}`);
});

// RN通信监听
rn_bridge.channel.on('message', (msg) => {
  rn_bridge.channel.send(`Received from RN: ${msg}`);
});

4. 修复RN端API调用 #

修改App.js中的testLocalAPI函数，使用127.0.0.1而非localhost（Android对localhost的解析存在问题）：

const testLocalAPI = async () => {
  try {
    const response = await fetch('http://127.0.0.1:3000/api/test');
    const data = await response.json();
    setServerMessage(data.message);
  } catch (error) {
    console.error('API Error:', error);
    setServerMessage('Failed to connect to server');
  }
};

生产APK打包注意事项 #

1. 预编译Node.js依赖：打包前进入nodejs-assets/nodejs-project执行npm install，确保所有依赖（包括ytdl-core）被正确打包到APK中。
2. Android权限：若需要网络请求，确保AndroidManifest.xml中添加权限：

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

3. 混淆配置：在android/app/proguard-rules.pro中添加规则，避免Node.js代码被混淆：

-keep class com.janeasystems.rn_nodejs_mobile.** { *; }
-keep class nodejs.** { *; }

验证步骤 #

1. 执行npx react-native run-android启动应用，查看控制台输出是否有Node服务器启动的消息。
2. 在App中测试API调用，确认服务器响应正常。
3. 测试ytdl-core接口，传入YouTube URL，验证返回的视频信息是否正确。

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