BigCommerce v8 CLI无法构建生产文件，部署报错求助

1. isModuleDeclaration 废弃提示 #

原因 #

报错源于项目依赖的ESLint或语法解析工具（如@babel/eslint-parser）版本过旧，与Node.js v18的语法检测逻辑不兼容。旧版本工具仍在调用已被Node.js/V8废弃的isModuleDeclaration API，当前环境要求替换为isImportOrExportDeclaration。

解决办法 #

• 升级ESLint及相关插件至兼容Node.js v18的版本：

  npm update eslint @babel/eslint-parser eslint-plugin-import --save-dev
  

• 若升级后问题仍存在，检查项目.eslintrc/.eslintrc.js配置文件，若有自定义规则直接调用isModuleDeclaration，手动替换为isImportOrExportDeclaration。

2. 打包资产文件未找到 #

原因 #

• 项目搁置期间，BigCommerce Stencil CLI的打包逻辑已更新，旧的资产路径配置（如stencil.config.js中的路径设置、assets/目录结构）与新版本CLI不匹配；
• 之前修复SCSS编译问题时，未执行完整的资源打包流程，导致部分资产文件未生成或路径错误。

解决办法 #

• 清理旧打包缓存后重新构建：

  stencil clean && stencil build
  

• 检查stencil.config.js中的paths配置，确认assetsDir、outputDir等路径与当前项目目录结构一致；
• 手动验证项目引用的静态资源（图片、字体等）是否存在于指定路径，修正相对路径错误。

3. Terser 报错 error:0308010C:digital envelope routines::unsupported #

原因 #

Node.js v17+默认启用了更严格的OpenSSL加密算法，而项目依赖的Terser版本过旧，不支持新算法，导致打包时触发SSL相关错误。

解决办法 #

• 升级Terser至兼容Node.js v18的版本：

  npm update terser --save-dev
  

• 若升级受限，可临时在启动命令中添加环境变量放宽加密限制（仅作临时方案，长期建议升级依赖）：

  NODE_OPTIONS=--openssl-legacy-provider stencil push
  

• 若使用Stencil CLI内置的Terser，尝试升级CLI本身：

  npm update @bigcommerce/stencil-cli -g
  

通用排查步骤 #

若单个问题的解决办法无效，可尝试：

• 删除node_modules和锁文件后重新安装依赖：

  rm -rf node_modules package-lock.json && npm install
  

• 确认Stencil CLI版本与BigCommerce文档指定版本匹配（通过stencil --version查看，不一致则重新安装指定版本）。

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