本段代码解决 更新测试环境构建命令以解决构建失败问题
//本项目是react+umi3+antdesign 搭建的后台管理系统
"build:test": "cross-env UMI_ENV=test NODE_OPTIONS=--openssl-legacy-provider umi build"
**原因:**Node.js v17+ 的 OpenSSL 3.0 与旧依赖不兼容。
**解决:**添加 NODE_OPTIONS=–openssl-legacy-provider 或降级到 Node.js v16。
1. 命令结构
2. 核心工具:cross-env
-
作用:解决不同操作系统(Windows、Mac、Linux)设置环境变量的语法兼容性问题。
-
例如:Windows 中设置环境变量用 set ENV=value,Unix 系统用 ENV=value。
-
cross-env 抹平了差异,让脚本跨平台运行。
-
-
为什么需要:确保开发者在任何系统下执行 npm run build:test 都不会报错。
3. 环境变量:UMI_ENV=test
-
Umi 框架特性:Umi 会根据 UMI_ENV 的值加载对应的配置文件。
- 例如:如果 UMI_ENV=test,会加载 config.test.ts 或 .env.test。
-
用途:区分不同环境的配置(如测试环境的 API 地址、调试模式等)。
-
文件约定:
config.ts # 默认配置 config.test.ts # 测试环境配置(当 UMI_ENV=test 时生效) config.prod.ts # 生产环境配置(当 UMI_ENV=prod 时生效)
4. Node.js 选项:NODE_OPTIONS=–openssl-legacy-provider
-
背景:Node.js v17+ 默认使用 OpenSSL 3.0,但某些旧项目或依赖库可能依赖 OpenSSL 1.x 的算法(如 MD5)。
-
作用:强制 Node.js 使用旧版 OpenSSL 提供者,避免构建时出现以下错误:
Error: error:0308010C:digital envelope routines::unsupported
-
何时需要:当项目依赖的库(如 webpack 4、旧版 npm 包)与新 OpenSSL 不兼容时。
-
长期方案:升级相关依赖或迁移到兼容 OpenSSL 3.0 的版本。
5. 构建命令:umi build
-
Umi 框架:一个企业级前端应用框架(基于 React),内置构建、路由、数据流管理等功能。
-
用途:执行 umi build 会触发以下操作:
-
根据 UMI_ENV 加载对应环境配置。
-
编译源代码(TypeScript/JavaScript、CSS、图片等)。
-
代码压缩、Tree Shaking、代码分割等优化。
-
生成静态文件到 dist 目录,供部署使用。
-
6. 完整执行流程
-
设置环境变量:通过 cross-env 设置 UMI_ENV=test。
-
调整 Node.js 行为:通过 NODE_OPTIONS 使用旧版 OpenSSL。
-
执行构建:运行 umi build,生成测试环境的产物。
7. 替代方案:永久修复 OpenSSL 问题
如果不想每次构建都加 NODE_OPTIONS,可以:
-
升级依赖:确保所有库兼容 OpenSSL 3.0。
-
修改 Node.js 配置(不推荐)
# 在系统环境变量中永久添加 export NODE_OPTIONS=--openssl-legacy-provider
总结
这个命令的作用是:在测试环境下,使用旧版 OpenSSL 提供者
,安全地构建 Umi 项目。核心解决了跨平台环境变量设置和 Node.js 新版本的兼容性问题
,适用于需要快速适配旧项目的场景
。