React Native中JavaScript normalize函数Android端兼容性问题咨询

这个问题根本不是NFD参数的锅——而是Android端的JavaScript引擎默认不支持String.prototype.normalize()方法，而iOS和Node.js（依赖V8引擎）、Debug模式下（用Chrome的V8）都完整支持这个Unicode标准化方法，所以才会出现你说的差异。

为什么会这样？ #

• iOS端的React Native默认使用的JavaScriptCore（JSC）是完整实现了ES6+的Unicode相关API的；
• Android端的JSC往往是裁剪过的版本（为了减小包体积），或者如果你用了Hermes引擎，旧版本的Hermes对normalize的支持不完善；
• Debug模式下，React Native会连接Chrome的V8引擎执行代码，V8天然支持normalize，所以不会报错。

解决方案：给Android端补上normalize的支持，或者做兼容处理 #

方案1：引入polyfill

可以直接安装一个轻量的polyfill库，比如string-normalize-polyfill，在你的React Native项目入口文件（比如index.js）里引入：

import 'string-normalize-polyfill';

这样就能在Android端补上normalize方法，你的原有代码不需要修改就能正常运行。

方案2：手动兼容+替代处理

如果不想引入额外依赖，可以修改你的sanitizeFileName函数，先检测normalize是否存在，不存在的话用正则直接替换常见的重音字符：

sanitizeFileName(fileName) {
  let encodedFileName = fileName || "upload";
  
  // 优先使用normalize（如果支持）
  if (typeof String.prototype.normalize === 'function') {
    encodedFileName = encodedFileName.normalize('NFD');
  } else {
    // 手动替换常见重音字符，覆盖大部分场景
    encodedFileName = encodedFileName
      .replace(/[àáâãäåāă]/g, 'a')
      .replace(/[èéêëēě]/g, 'e')
      .replace(/[ìíîïī]/g, 'i')
      .replace(/[òóôõöōǒ]/g, 'o')
      .replace(/[ùúûüūǔ]/g, 'u')
      .replace(/[ýÿ]/g, 'y')
      .replace(/[ñ]/g, 'n')
      .replace(/[ç]/g, 'c');
  }
  
  // 移除所有非字母数字字符
  encodedFileName = encodedFileName.replace(/[^a-zA-Z0-9]/g, '_');
  return encodedFileName;
}

方案3：切换到完整的JSC（Android）

如果你用的是旧版React Native的Android JSC，可以替换成完整版本的JSC包，比如在android/app/build.gradle里添加：

dependencies {
  // 替换成完整的JSC
  implementation 'org.webkit:android-jsc:r241213'
}

不过这个方案会增加APK体积，需要权衡。

验证 #

修改后，在Android Release模式下测试文件上传，应该就能正常处理含重音字符的文件名了。

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