HarmonyOS鸿蒙Next中RN如何在不改业务代码的前提下，不同平台引入不同的库

你的场景在 RN 鸿蒙化里其实很常见：

Android:
rn-fetch-blob

HarmonyOS:
@react-native-ohos/react-native-blob-util

如果业务代码里已经有大量：

import RNFetchBlob from 'rn-fetch-blob'

确实不可能一个个改。

最推荐方案：Alias 映射（基本不改业务代码）

直接让：

import RNFetchBlob from 'rn-fetch-blob'

在鸿蒙编译时实际加载：

@react-native-ohos/react-native-blob-util

Metro配置

在 metro.config.js 中增加：

const path = require('path');

module.exports = {
  resolver: {
    extraNodeModules: {
      'rn-fetch-blob': path.resolve(
        __dirname,
        'node_modules/@react-native-ohos/react-native-blob-util'
      ),
    },
  },
};

这样业务代码无需修改。

更稳的方案：自定义兼容层

创建：

src/libs/RNFetchBlob/index.js

内容：

import { Platform } from 'react-native';

let BlobModule;

if (Platform.OS === 'harmony') {
  BlobModule = require('@react-native-ohos/react-native-blob-util').default;
} else {
  BlobModule = require('rn-fetch-blob').default;
}

export default BlobModule;

然后在 Babel 中配置别名：

module-resolver

把：

rn-fetch-blob

映射到：

src/libs/RNFetchBlob

配置示例：

plugins: [
  [
    'module-resolver',
    {
      alias: {
        'rn-fetch-blob': './src/libs/RNFetchBlob',
      },
    },
  ],
];

这样业务代码也完全不用改。

为什么你封装后还是报错

大概率是下面两种情况之一：

情况1

文件顶部直接 import

import RNFetchBlob from 'rn-fetch-blob'

即使：

if (Platform.OS === 'harmony')

也没用。

因为：

Bundle阶段已经解析模块

找不到就直接报错。

情况2

Harmony侧根本没安装

rn-fetch-blob

Metro解析失败。

例如：

import RNFetchBlob from 'rn-fetch-blob'

编译时：

Unable to resolve module rn-fetch-blob

根本到不了运行时判断。

如果是 RN 0.77

我更推荐：

Babel Alias
+
module-resolver

方案。

因为：

• 不改业务代码
• 不需要大量 Platform.OS 判断
• Android继续用 rn-fetch-blob
• Harmony自动切换 react-native-blob-util

这种方式也是很多大型 RN 鸿蒙化项目（几万行以上代码）的常见做法。

需要注意

还要确认：

@react-native-ohos/react-native-blob-util

与：

rn-fetch-blob 0.12.0

API 是否完全兼容。

虽然大部分接口保持一致，但以下能力可能存在差异：

• fs
• fetch
• session
• androidDownloadManager
• media scanner
• content uri

如果项目大量使用这些高级能力，建议先做一轮 API 差异验证。

对于你这种已有大量历史代码的项目，我建议优先采用 Babel Alias 映射方案，基本可以做到：

业务代码 0 改动
Android 正常
Harmony 自动切换实现

这是成本最低、维护性最好的做法。