更新测试环境构建命令以解决构建失败问题

本段代码解决 更新测试环境构建命令以解决构建失败问题

//本项目是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 会触发以下操作：

  1. 根据 UMI_ENV 加载对应环境配置。

  2. 编译源代码（TypeScript/JavaScript、CSS、图片等）。

  3. 代码压缩、Tree Shaking、代码分割等优化。

  4. 生成静态文件到 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 新版本的兼容性问题，适用于需要快速适配旧项目的场景。