Next.js生产环境使用next-mdx-remote读取MDX文件时触发EEXIST错误导致500报错

兄弟，我之前也在虚拟主机上碰到过Next.js生产环境的这类奇怪报错，结合你给出的EEXIST错误栈（说实话这个调用栈指向stdin和模块加载，刚开始看确实有点懵），给你几个实际能落地的排查和解决方向：

• 先排查MDX文件的路径与权限问题
  本地跑没问题不代表生产环境也ok，虚拟主机的文件系统坑很多：

  • 先确认Next.js进程有读取MDX文件所在目录的权限，比如你的MDX存在content/posts下，要给这个目录设置正确的读权限（Linux下一般是chmod 755目录，chmod 644文件）
  • 注意文件名大小写！本地Windows/Mac是大小写不敏感的，但生产环境Linux是敏感的，比如本地是HelloWorld.mdx，生产上是helloworld.mdx，就会导致路径匹配异常，甚至触发奇怪的文件冲突
  • 检查你读取MDX的代码里的路径是不是硬编码了本地绝对路径？比如本地写的/Users/xxx/my-blog/content，到生产环境这个路径根本不存在，要换成相对路径或者用process.cwd()拼接正确路径，比如：

    import path from 'path';
    const postsDir = path.join(process.cwd(), 'content', 'posts');
    

• 调整next-mdx-remote的使用逻辑，避免资源冲突
  这个EEXIST错误虽然看起来和文件存在有关，但调用栈指向模块加载，大概率是生产环境多进程/重复读取导致的资源竞争：

  • 如果你是在getServerSideProps里动态读取MDX文件，改成用getStaticProps+getStaticPaths做静态生成，把MDX内容在构建时就预编译好，请求时直接返回静态内容，避免运行时重复读取文件
  • 确保你读取MDX的逻辑是幂等的，不要在循环里重复调用文件读取函数，也不要尝试在只读目录下创建临时文件（next-mdx-remote可能会生成缓存文件，要确保它有写入临时目录的权限，或者禁用缓存）
  • 可以把读取MDX的逻辑封装成一个工具函数，比如：

    import fs from 'fs/promises';
    import path from 'path';
    
    export async function getMdxContent(slug) {
      const filePath = path.join(process.cwd(), 'content', 'posts', `${slug}.mdx`);
      try {
        const content = await fs.readFile(filePath, 'utf8');
        return content;
      } catch (err) {
        console.error(`读取MDX文件失败: ${filePath}`, err);
        throw err;
      }
    }
    

    这样能更清晰地处理错误，也方便排查问题

• 检查虚拟主机的Node.js环境与部署配置

  • 确认生产环境的Node.js版本和本地一致，Next.js 14.2.2要求Node.js 18.17+，版本不匹配会有各种奇怪的模块加载问题
  • 如果虚拟主机用了PM2或者其他进程管理器，看看是不是启动了多个Next.js进程，导致同时读取同一个MDX文件触发资源冲突，试试改成单进程启动，或者给进程加文件锁
  • 确保启动命令里设置了NODE_ENV=production，比如NODE_ENV=production next start，开发环境的配置在生产环境会有兼容性问题

如果上面的方法都没解决，你可以试试把next-mdx-remote升级到最新版本，或者换成Next.js官方的@next/mdx方案，官方方案在生产环境的兼容性会更好一些。

备注：内容来源于stack exchange，提问作者DevQandA