React.js出现Wasm-function memory access out of bounds错误如何解决

该RuntimeError: memory access out of bounds属于WebAssembly运行时内存越界错误，从报错栈的allocate_mappings调用逻辑判断，90%以上概率是项目依赖中用到Wasm实现的工具包（比如语法转译器、压缩工具、图像处理依赖等）出现了版本不兼容、缓存损坏，或者调用Wasm方法时传入了非法参数。 #

• 不要仅删除node_modules解决问题，同步删除项目根目录的对应锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml），执行npm cache clean --force后再重新执行npm install，可以大幅降低复现概率。
• 排查报错首次出现前新增的依赖，重点关注esbuild、swc、sharp这类默认使用Wasm实现的第三方包，尝试将对应依赖升级到最新稳定版，或者回退到报错前的可用版本。
• 检查你当前使用的Node.js版本，部分Wasm依赖对Node版本有强制要求，建议切换到项目初始化时使用的Node LTS版本（如16.x、18.x稳定版）测试，避免使用非LTS的Node版本。
• 打开报错指向的src/components/admin/personal_request/personal_request.jsx文件，排查该组件内是否有直接引入Wasm模块、调用Wasm方法的逻辑，检查调用时传入的参数是否符合要求：比如是否传入了超出预期长度的数组、未初始化的空值等非法入参，这类问题也会触发Wasm内存越界。
• 如果你使用的是自定义Webpack/Vite配置，检查Wasm相关配置是否被改动：比如Webpack的experiments.asyncWebAssembly开关是否正常开启，Vite的optimizeDeps配置是否错误排除了Wasm相关依赖。

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