创建Next.js 15.0.1项目后运行npm run dev遇构建错误

问题根源 #

这是Next.js 15.0.1在Windows系统下的路径转义bug，同时错误地将favicon.ico识别为Open Graph（OG）图片进行大小检测，导致webpack解析时出现转义字符错误，且误报文件大小超标。

具体修复步骤 #

• 检查Metadata配置：打开app/layout.tsx或项目中的metadata配置文件，确认是否误将favicon.ico配置到了opengraph.image字段中。如果是，替换为正确的OG图片路径，或者删除该错误配置项。
• 清理缓存重启服务：
  1. 删除项目根目录下的.next文件夹
  2. 执行命令重启开发服务：npm run dev
• 升级Next.js补丁版本：该bug大概率已在15.0.1后续的小版本中修复，执行命令升级到最新兼容版本：

  npm install next@latest
  

• 临时规避方案：如果以上方法无效，可在next.config.ts中添加配置禁用OG图片大小检测（不推荐长期使用）：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    experimental: {
      metadataRoute: {
        imageSizeLimit: false,
      },
    },
  };
  
  export default nextConfig;
  

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