hbuilder uniapp Error: error:0308010C:digital envelope routines::unsupported

### 解决 CompressionPlugin 错误 (error:0308010C:digital envelope routines::unsupported) 在 Vue 和 Webpack 开发环境中，当使用 Node.js 版本较高时可能会触发 `CompressionPlugin` 或其他插件的相关错误 `error:0308010C:digital envelope routines::unsupported`。以下是几种常见的解决方案： #### 方法一：调整 Node.js 版本 Node.js 高版本可能引入了一些不向后兼容的功能，这可能导致旧版依赖出现问题。可以通过以下方式降级 Node.js 到较低版本来解决问题。 - 使用 nvm（Node Version Manager）管理 Node.js 版本： ```bash nvm install 14.17.0 # 安装指定版本的 Node.js nvm use 14.17.0 # 切换到该版本 ``` 此方法适用于因高版本 Node.js 导致的问题[^2]。 #### 方法二：设置环境变量 `NODE_OPTIONS` 如果不想更改全局 Node.js 版本，可以尝试通过配置环境变量的方式启用 OpenSSL 的遗留提供程序支持。具体操作如下： - 修改项目的 `package.json` 文件，在脚本部分添加环境变量： ```json { "scripts": { "dev": "SET NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve" } } ``` 对于 Linux/Mac 用户，则应改为： ```json { "scripts": { "dev": "export NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve" } } ``` 这种方法能够有效解决由加密算法更新引发的兼容性问题[^3]。 #### 方法三：升级相关依赖库 有时，项目中的某些依赖项未及时适配最新标准也可能引起此类报错。因此建议执行以下命令以确保所有必要的包都处于最新状态： ```bash npm update --save-dev npm audit fix --force ``` 此外还可以单独针对 crypto 模块或者 compression 插件进行重新安装验证其稳定性。 #### 方法四：修改 Webpack 配置文件 如果你有权限访问并编辑 Webpack 设置的话, 尝试禁用掉压缩功能作为临时措施: ```javascript const CompressionWebpackPlugin = require('compression-webpack-plugin'); module.exports = { configureWebpack: config => { const plugins = []; if (!process.env.NODE_ENV === 'production') { // 移除生产模式下的压缩插件 delete config.plugins.find(plugin => plugin instanceof CompressionWebpackPlugin); } return {plugins}; }, } ``` 以上四种方案均能不同程度缓解或彻底消除上述提到的技术难题[^1]。 --- ###

<think>好的，用户遇到了CompressionPlugin导致的错误：error:0308010C:digital envelope routines::unsupported。我需要先理解这个问题出现的原因。根据之前的引用内容[^1]，这个错误通常与Node.js 17及以上版本中使用的OpenSSL 3.0有关，某些旧的加密算法可能不被支持了。用户提到他们之前通过修改package.json中的启动脚本添加了--openssl-legacy-provider参数解决了类似问题，但现在在使用CompressionPlugin时又遇到了同样的错误。 首先，我应该确认用户的环境是否确实使用了Node.js 17或更高版本。如果用户升级了Node.js版本，可能导致构建工具链中的某些插件依赖旧版OpenSSL，从而触发此错误。接下来，我需要考虑如何将解决方案应用到CompressionPlugin的配置中，而不仅仅是启动脚本。 可能的解决方案包括： 1. 环境变量设置：在运行命令前设置NODE_OPTIONS环境变量，添加--openssl-legacy-provider选项。例如，在启动命令前加上`export NODE_OPTIONS=--openssl-legacy-provider`（Linux/macOS）或`set NODE_OPTIONS=--openssl-legacy-provider`（Windows），然后再运行构建命令。但用户可能希望这个设置在项目内持久化，而不是每次手动输入。 2. 修改构建脚本：在package.json的scripts部分，将构建命令修改为`"build": "react-scripts --openssl-legacy-provider build"`，这样每次运行npm run build时会自动应用该选项。但需要确认用户是否使用react-scripts，比如在Create React App项目中。如果是其他构建工具，可能需要调整相应的命令。 3. 降级Node.js版本：建议用户暂时降级到Node.js 16.x，这是一个长期支持版本，可能更稳定，避免此问题。但长期来看，降级并不是最佳方案，应该寻求配置上的调整。 4. 全局配置OpenSSL：通过设置环境变量OPENSSL_CONF指向旧版配置，但这种方法可能比较复杂，且不推荐，除非必要。 用户之前已经通过修改start脚本解决了类似问题，现在问题出现在构建过程中，特别是与CompressionPlugin相关。可能CompressionPlugin在构建时调用了某些加密函数，导致同样的OpenSSL问题。因此，解决方案应聚焦于在构建命令中添加--openssl-legacy-provider选项。 另外，用户可能需要检查webpack配置中的CompressionPlugin设置，是否有特定选项触发了这个问题。比如，是否启用了特定的加密算法？或者是否需要更新CompressionPlugin到最新版本，以兼容OpenSSL 3.0？ 总结解决方案步骤： 1. 在构建命令中添加--openssl-legacy-provider选项，确保构建过程使用旧版OpenSSL提供程序。 2. 更新相关依赖（如CompressionPlugin、webpack等）到最新版本，确保兼容性。 3. 作为临时方案，降级Node.js到16.x版本。 4. 检查是否有其他配置或环境变量需要调整，以全面解决问题。 还需要提醒用户注意，使用--openssl-legacy-provider可能存在安全风险，因此长期应寻求更新依赖或调整配置来兼容新版的OpenSSL，而不是依赖旧版。</think>### 解决方案：CompressionPlugin报错`error:0308010C`的修复方法 #### 问题原因 此错误是由于Node.js 17+版本默认使用OpenSSL 3.0，移除了部分旧版加密算法支持，而依赖库（如`CompressionPlugin`内部使用的压缩模块）仍尝试调用旧算法导致[^1]。 --- #### 解决方案步骤 ##### 方案1：添加环境变量（推荐） 在构建命令中注入OpenSSL旧版兼容模式： ```bash # Linux/macOS export NODE_OPTIONS=--openssl-legacy-provider && npm run build # Windows (PowerShell) $env:NODE_OPTIONS="--openssl-legacy-provider"; npm run build ``` ##### 方案2：永久修改npm脚本（适用于前端工程） 在`package.json`中修改构建脚本： ```json { "scripts": { "build": "react-scripts --openssl-legacy-provider build" } } ``` *适用于Create React App、Vue CLI等框架*[^1]。 ##### 方案3：全局降级Node.js版本（临时方案） 使用Node.js 16.x LTS版本（兼容性更好）： ```bash # 通过nvm管理版本 nvm install 16.20.2 nvm use 16.20.2 ``` ##### 方案4：检查依赖兼容性 更新相关插件以确保支持OpenSSL 3.0： ```bash npm update compression-webpack-plugin webpack ``` --- #### 验证结果 执行构建命令后若不再报错，且生成压缩文件（如.gz/.br）正常，则修复成功。 ---