feat(preset-umi): throw by default when pre-render error

docs/docs/docs/api/config.md

@@ -585,7 +585,7 @@ export default {
 
 ## exportStatic
 
-- 类型：`{ extraRoutePaths: IUserExtraRoute[] | (() => IUserExtraRoute[] | Promise<IUserExtraRoute[]>) }`
+- 类型：`{ extraRoutePaths: IUserExtraRoute[] | (() => IUserExtraRoute[] | Promise<IUserExtraRoute[]>), ignorePreRenderError: boolean }`
 - 默认值：`undefined`
 
 开启该配置后会针对每个路由单独输出 HTML 文件，通常用于静态站点托管。例如项目有如下路由：
@@ -654,6 +654,17 @@ export default {
 }
 ```
 
+`exportStatic` 在搭配 `ssr` 使用时会进行预渲染，在预渲染失败时会抛出异常并终止构建，可以通过配置 `ignorePreRenderError` 来忽略预渲染失败的错误，例如：
+
+```ts
+// .umirc.ts
+export default {
+  exportStatic: {
+    // 忽略预渲染失败的错误
+    ignorePreRenderError: true,
+  },
+}
+```
 
 ## favicons
 

packages/preset-umi/src/features/exportStatic/exportStatic.ts

@@ -58,6 +58,9 @@ function getExportHtmlData(routes: Record<string, IRoute>): IExportHtmlItem[] {
  * get pre-rendered html by route path
  */
 async function getPreRenderedHTML(api: IApi, htmlTpl: string, path: string) {
+  const {
+    exportStatic: { ignorePreRenderError = false },
+  } = api.config;
   markupRender ??= require(absServerBuildPath(api))._markupGenerator;
 
   try {
@@ -82,6 +85,9 @@ async function getPreRenderedHTML(api: IApi, htmlTpl: string, path: string) {
     logger.info(`Pre-render for ${path}`);
   } catch (err) {
     logger.error(`Pre-render ${path} error: ${err}`);
+    if (!ignorePreRenderError) {
+      throw err;
+    }
   }
 
   return htmlTpl;
@@ -126,6 +132,7 @@ export default (api: IApi) => {
               zod.function(),
               zod.array(zod.string()),
             ]),
+            ignorePreRenderError: zod.boolean().default(false),
           })
           .deepPartial(),
     },