Forge Jira应用因top-level-await实验未启用无法运行，找不到webpack.config.js怎么办？

问题原因 #

Forge框架默认封装了Webpack配置，不会在项目根目录生成webpack.config.js，所以你找不到这个文件。要启用Top-Level-Await，需要通过Forge提供的自定义配置方式修改Webpack设置。

解决方案步骤 #

1. 创建自定义Webpack配置文件
   在项目根目录新建名为forge.webpack.config.js的文件，这是Forge官方支持的自定义Webpack配置入口。

2. 添加Top-Level-Await配置
   在新建文件中写入以下代码，合并默认配置并启用目标特性：

module.exports = (config, { mode }) => {
  // 保留原有配置的同时启用topLevelAwait
  config.experiments = {
    ...config.experiments,
    topLevelAwait: true
  };
  return config;
};

3. 重新运行应用
   执行Forge启动命令（如forge tunnel或forge deploy），新配置会被自动加载，Top-Level-Await相关错误即可解决。

备选方案（无需修改配置） #

如果顶层await并非必须，可以重构代码规避：
将顶层await逻辑包裹在异步函数中并立即执行：

async function initApp() {
  // 原顶层await代码移至此处
  const data = await fetchRequiredData();
  // 后续业务逻辑
}
initApp();

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