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

Next.js出现「Failed to compile pages/_app.js」编译错误如何解决?

Next.js 编译报错「Failed to compile pages/_app.js」修复方案

报错详情截图

  • 第一步:排查pages/_app.js语法错误

    该问题90%以上是_app.js文件本身语法问题触发,重点检查以下内容:

    1. 所有import语句的路径是否正确,是否存在拼写错误、大小写不匹配的问题
    2. 组件是否使用export default正确导出,没有出现多次导出、导出名称不匹配的问题
    3. JSX语法是否符合规范,所有标签正确闭合,没有出现符号拼写错误
    4. 是否引用了未安装的第三方依赖包
  • 第二步:重置项目依赖
    语法无问题的情况下,优先排查依赖不兼容/安装不全问题,执行以下命令重置依赖:
    # 删除旧依赖和锁文件
    rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
    # 重新安装依赖,根据你使用的包管理器选对应命令
    npm install
    # yarn install
    # pnpm install
    
    依赖安装完成后重新执行npm run dev启动编译验证。
  • 第三步:排查配置文件问题
    如果你近期修改过next.config.js、jsconfig.json/tsconfig.json配置,先回滚最近的配置改动,重启编译验证是否是配置错误导致的编译失败。
  • 第四步:排查样式导入问题
    如果在_app.js中导入了全局样式,确认导入写法正确,没有把样式文件当作组件导入;如果使用CSS Module,确认样式文件名符合xxx.module.css/xxx.module.scss的命名规范。

内容的提问来源于stack exchange,提问作者MR.niceman

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.05 11:30:03