You need to enable JavaScript to run this app. Next.js的getStaticProps无法从MDX文件导入元数据问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Next.js的getStaticProps无法从MDX文件导入元数据问题排查

问题根因
  • Webpack 构建时会对 import()、require() 做静态分析,只有路径包含可识别的静态前缀、能提前圈定范围的文件才会被 MDX loader 提前编译纳入构建产物。纯变量传入的路径 Webpack 无法预判需要加载的文件,不会处理对应的 .mdx 文件,运行时自然提示找不到模块。
  • 你使用 process.cwd() 拼接的绝对路径不符合 Next.js 构建阶段的模块解析规则,也会触发模块找不到的报错。
解决方案

方案1:改用 Front Matter 存储元数据(推荐)

这是 Next.js 处理本地 MDX 内容的主流方案,完全避开动态导入的限制,性能更稳定。

  1. 调整 MDX 文件格式,把元数据放到文件顶部的 Front Matter 区块:
---
title: 'title'
date: 'May 09, 2019'
---

Content
  1. 安装 gray-matter 用来解析 Front Matter 内容,修改 getStaticProps 代码:
import fs from 'fs/promises'
import path from 'path'
import matter from 'gray-matter'
import recRead from 'recursive-readdir'

export const getStaticProps = async () => {
  const pagesDir = path.join(process.cwd(), 'pages')
  // 读取pages目录下除了.tsx之外的所有文件
  const postFilenames = await recRead(pagesDir, ['*.tsx'])
  
  const postMetadata = await Promise.all(
    postFilenames.map(async (filePath) => {
      // 直接读取文件内容解析元数据
      const fileContent = await fs.readFile(filePath, 'utf8')
      const { data: meta } = matter(fileContent)
      meta.date = new Date(meta.date)
      return meta
    })
  )

  return {
    props: {
      postMetadata
    }
  }
}

方案2:保留原meta写法,给动态导入加静态前缀

如果一定要保留 export const meta 的写法,需要让 Webpack 能提前识别要打包的文件范围:
动态导入时不要把完整路径放在变量里,把静态路径前缀写死,只把可变部分放在变量中拼接:

// postPath 是相对于pages目录的路径,示例值:wielka-brytania/1.mdx
const meta = await import(`../pages/${postPath}`)

Webpack 识别到 ../pages/ 这个固定前缀后,会提前把 pages 目录下所有 .mdx 文件交给 MDX loader 编译处理,动态导入就能正常命中模块。


内容的提问来源于stack exchange,提问作者Oliwier Zgórniak

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.16 19:54:03