当 BABEL_ENV=development 时 Webpack 构建报错“Unexpected token”，根源在于 @superset-ui/embedded-sdk 的编译产物中使用了未被开发环境 Babel 配置支持的可选链操作符（?.），需通过配置升级或代码降级确保兼容性。

当 `babel_env=development` 时 webpack 构建报错“unexpected token”，根源在于 `@superset-ui/embedded-sdk` 的编译产物中使用了未被开发环境 babel 配置支持的可选链操作符（`?.`），需通过配置升级或代码降级确保兼容性。

该错误本质是环境不一致导致的语法兼容性问题：@superset-ui/embedded-sdk 的 lib/index.js 文件在生产构建（BABEL_ENV=production）中能正常运行，是因为其打包产物可能已由上游预编译为 ES5 兼容代码；但在开发模式下，Webpack 会直接通过 babel-loader 解析该模块的 .js 文件，而默认开发 Babel 配置（尤其较旧版本）往往未启用对可选链（?.）、空值合并（??）等 ES2020+ 语法的支持，导致解析失败。

错误行 const filterConfig = dashboardUiConfig?.filters || {}; 中的 ?. 即为典型触发点。虽然手动修改 node_modules 中的文件（如将 ?. 替换为 && 判断）可临时绕过问题，但这不是可持续方案——该修改会在 yarn install 或依赖更新后丢失，且违反工程最佳实践。

✅ 推荐解决方案（按优先级排序）：

1. 升级并统一 Babel 配置，显式启用可选链支持
   确保项目根目录的 babel.config.js（或 .babelrc）包含 @babel/plugin-proposal-optional-chaining 插件，并在开发与生产环境均启用：

   // babel.config.js
   module.exports = {
     presets: [
       ['@babel/preset-env', {
         targets: {
           node: 'current',
           browsers: ['> 0.5%', 'last 2 versions', 'not dead']
         },
         modules: false // 保持 ESM 供 webpack tree-shaking
       }],
       '@babel/preset-react'
     ],
     plugins: [
       '@babel/plugin-proposal-optional-chaining',
       '@babel/plugin-proposal-nullish-coalescing-operator'
     ]
   };

   ✅ 注意：@babel/preset-env 默认不包含实验性语法插件，必须显式添加。

2. 强制 babel-loader 处理 node_modules/@superset-ui（谨慎使用）
   若 SDK 发布的是未转译的源码（如 main 字段指向 src/），需在 webpack.config.js 中调整 babel-loader 的 include 规则：

   {
     test: /\.(js|jsx)$/,
     include: [
       path.resolve(__dirname, 'src'),
       path.resolve(__dirname, 'node_modules/@superset-ui/embedded-sdk') // 显式包含
     ],
     use: { loader: 'babel-loader' }
   }

   同时确保该路径下的代码能被上述 Babel 插件正确处理。

3. 临时规避（仅限紧急调试）
   如需快速验证，可局部 patch：

   • 使用 patch-package 创建持久化补丁（推荐）；
   • 或在 postinstall 脚本中自动替换（不推荐长期使用）。

⚠️ 重要提醒：

• 切勿直接编辑 node_modules 并提交至 Git；
• 检查 @superset-ui/embedded-sdk 版本是否已修复此问题（新版本可能已发布转译后的 dist/ 目录）；
• 运行 npx babel --version 和 npx webpack --version 确认工具链版本兼容性（建议 @babel/core >= 7.14.0）。

通过标准化 Babel 配置并明确启用现代 JavaScript 语法支持，即可一劳永逸地解决开发环境解析失败问题，同时保障团队协作与持续集成的稳定性。