执行npx react-native run-android遇RNGP自动链接packageName缺失错误

问题场景 #

执行命令npx react-native run-android --deviceId emulator-5554时触发构建失败，错误提示：

> Task :app:generateAutolinkingPackageList FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:generateAutolinkingPackageList'.
> RNGP - Autolinking: Could not find project.android.packageName in react-native config output! Could not autolink packages without this field.

已完成的操作：

• 在项目根目录的react-native.config.js中配置了packageName：

  module.exports = {
      project: {
        android: {
          sourceDir: './android',
          packageName: 'com.mypack.laundrycustomer',
        },
      },
    };
  

• 修改了android/app/src/main/AndroidManifest.xml的package属性：

  <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.mypack.laundrycustomer">
          <uses-permission android:name="android.permission.INTERNET" />
  

• 执行./gradlew clean后构建成功，但再次运行run-android命令仍报错。

解决方案 #

1. 确认React Native配置是否被正确读取 #

执行以下命令检查配置输出：

npx react-native config

查看输出中的project.android.packageName是否与你配置的com.mypack.laundrycustomer一致。如果未找到该字段，检查：

• react-native.config.js是否放在项目根目录
• 文件格式是否正确（无语法错误）

2. 同步Android项目的applicationId #

打开android/app/build.gradle，确保defaultConfig中的applicationId与packageName完全匹配：

android {
    defaultConfig {
        applicationId "com.mypack.laundrycustomer"
        // 其他配置项...
    }
}

3. 清除React Native缓存 #

除了Gradle缓存，还需要清除React Native的打包缓存：

npx react-native start --reset-cache

缓存重置完成后，重新执行构建命令。

4. 强制重新执行Autolinking #

手动触发autolinking流程，确保所有依赖链接配置正确生成：

npx react-native autolink

完成后再次运行npx react-native run-android --deviceId emulator-5554。

5. 检查版本兼容性 #

当前使用的Android Gradle Plugin（8.6.0）和Gradle（8.10.2）需要与你的React Native版本兼容。如果版本不匹配，可尝试：

• 调整Gradle或AGP版本至React Native官方推荐的组合
• 升级React Native到支持当前AGP/Gradle版本的最新稳定版

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