【Next.js 构建报错】ReferenceError: isExport is not defined

[LxhNolan]

描述遇到的问题
更新NotionNext时，Vercel报错。
13:53:03.463 Error occurred prerendering page "/zh-CN/article/bvemain". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.463 ReferenceError: isExport is not defined
13:53:03.571 Error occurred prerendering page "/zh-CN/article/edit". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.571 ReferenceError: isExport is not defined
13:53:03.653 Error occurred prerendering page "/zh-CN/article/wjgscjwj". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.654 ReferenceError: isExport is not defined
13:53:03.747 Error occurred prerendering page "/zh-CN/article/wjgsdtwj". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.748 ReferenceError: isExport is not defined
13:53:03.885 Error occurred prerendering page "/zh-CN/article/wjgsclwj". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.885 ReferenceError: isExport is not defined
13:53:03.961 Error occurred prerendering page "/zh-CN/article/howtoinstallbveex". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:03.961 ReferenceError: isExport is not defined
13:53:04.095 Error occurred prerendering page "/zh-CN/article/howtoinstallbve". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:04.095 ReferenceError: isExport is not defined
13:53:04.163 Error occurred prerendering page "/zh-CN/article/psgd". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:04.163 ReferenceError: isExport is not defined
13:53:04.240 Error occurred prerendering page "/zh-CN/article/bzxl". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:04.241 ReferenceError: isExport is not defined
13:53:04.300 Error occurred prerendering page "/zh-CN/article/zzlxsj". Read more: https://nextjs.org/docs/messages/prerender-error
13:53:04.301 ReferenceError: isExport is not defined
13:53:09.352 error Command failed with exit code 1.
13:53:09.383 Error: Command "yarn run build" exited with 1

相应配置
notion_page_id: 230d34c70fe581358dbcd6e8e49f58ca

截图

环境

• 操作系统: [windows]
• 浏览器 [Edge]
• 版本 [latest]

[cllcall]

一样的错误

[yanboim]

同样

[qianzhu18]

看起来和我本地复现到的是同一个问题：[prefix] / [prefix]/[slug] / [prefix]/[slug]/[...suffix] 这几条 slug 路由在 getStaticProps 里直接调用了 isExport()，但当前基线里这个标识在这些文件中并不在作用域内，所以静态导出阶段会报 ReferenceError: isExport is not defined，并集中出现在 /zh-CN/article/... 这类页面的 prerender。

我已经提了修复 PR：#4044

这个修复把上述路由里的判断改成了本地静态导出标记 process.env.EXPORT === "true"，保持原本 export 模式下的 revalidate 行为不变，同时避免构建时访问未定义的 isExport。

本地验证：

• yarn type-check 通过
• 相关页面文件 lint 无新错误（只剩已有 hook warnings）
• yarn export 已经越过先前会报 isExport is not defined 的阶段，未再复现该错误

如果你这边现在已经不再报错，大概率也是因为用了等价修复，或者相关代码已经切到包含该补丁的分支了。

[88lin]

已提交修复 PR：#4046

根因分析

PR #4033 在将 getStaticPaths 逻辑抽取到 getStaticPathsBase() 时，删除了三个路由文件中的 import { isExport } from '@/lib/utils/buildMode'，但这些文件的 getStaticProps 中仍然调用了 isExport() 来决定 ISR 的 revalidate 值：

// 以下三个文件的 getStaticProps 均受影响：
// pages/[prefix]/index.js
// pages/[prefix]/[slug]/index.js
// pages/[prefix]/[slug]/[...suffix].js

return {
  props,
  revalidate: isExport()  // ← ReferenceError: isExport is not defined
    ? undefined
    : siteConfig('NEXT_REVALIDATE_SECOND', BLOG.NEXT_REVALIDATE_SECOND, props.NOTION_CONFIG),
  notFound: !props.post
}

这是构建阶段所有页面预渲染失败的直接原因。

修复内容（PR #4046）

在保留 #4033 构建优化方向的基础上，修补了以下问题：

1. 恢复 isExport 导入 — 三个路由文件补回 import { isExport } from '@/lib/utils/buildMode'，修复构建崩溃
2. 修复 rejected promise 缓存泄漏 — getSharedAllPages 在 Notion 数据获取失败时，rejected promise 会永久驻留在 inProcessAllPagesPromises 中，导致后续请求无法重试。已添加 .catch() 清理逻辑，并补充了对应的测试用例
3. 统一缓存键默认值 — getStaticPathsCacheKey 的 pageId 回退值从 'default' 对齐为 BLOG.NOTION_PAGE_ID，与 fetchGlobalAllData 保持一致，避免缓存键不匹配
4. 修正 tag 清理顺序 — 将 cleanTagOptions 调整到 cleanPages 之前执行，避免页面保留对已删除标签的引用导致标签页 404

验证结果

✅ yarn test __tests__/lib/staticPaths.test.js --runInBand
✅ yarn test --runInBand
✅ yarn type-check
✅ yarn build
✅ yarn export

临时解决方案

如果需要立即恢复部署，可以在合并 PR 前，手动在以下三个文件中添加一行导入：

import { isExport } from '@/lib/utils/buildMode'

涉及文件：

• pages/[prefix]/index.js
• pages/[prefix]/[slug]/index.js
• pages/[prefix]/[slug]/[...suffix].js