You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

NextJS执行next build静态导出失败,寻求解决方案

问题

我用NextJS + TailwindCSS开发项目,打算静态导出后部署到Apache服务器,但执行next build时一直报useContext相关错误,可我自己的.tsx文件里根本没用到这个API。

报错截图:
错误信息

我的next.config.js配置:

/** @type {import('next').NextConfig} */
const nextConfig = {
    output: 'export'
};

export default nextConfig;
解决思路
  1. 排查第三方依赖/组件库:很多UI组件库(比如MUI、NextUI这类)内部会用到useContext,而NextJS的静态导出模式(output: 'export')不允许在React Server Components里运行客户端API。如果你的项目用了App Router,这些依赖必须放在标记了'use client'的组件里。
  2. 强制标记客户端组件:如果是App Router架构,把所有引入第三方UI组件的文件顶部加上'use client'指令,确保这些组件在客户端环境运行。
  3. 升级/降级Next.js版本:部分NextJS版本在静态导出App Router项目时存在兼容性bug,试试升级到最新稳定版,或者降级到v13.4.12及以后的版本(这个版本开始对静态导出的支持更完善)。
  4. 排查组件渲染逻辑:如果是Page Router,别在getStaticProps等服务器端逻辑里引入客户端组件;如果是App Router,避免在Server Components里直接导入客户端依赖。
  5. 最小化复现测试:新建一个干净的NextJS + Tailwind项目,配置好静态导出,确认能正常构建后,逐步添加你的组件和依赖,找到触发报错的具体模块。

内容的提问来源于stack exchange,提问作者Cecco

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.17 11:02:38