本地 npm run dev 能跑,不代表生产构建一定成功。上线前应跑一次 next build,确认类型、动态路由和静态生成都按预期工作。
使用 generateStaticParams 预生成已知 slug 的文章页,可以把博客详情变成构建期静态页,访问更快,也减少运行时查数据的开销。未知 slug 再走 404。
环境变量
只在服务端使用的密钥不要加 NEXT_PUBLIC_ 前缀。客户端能读到的变量都会进入浏览器包。Mock 阶段可以没有密钥,但一旦接上真实 CMS,就要把读写权限和环境隔离想清楚。
上线检查清单
确认 404 页可访问、文章内链能从列表点进详情、metadata 在构建产物里正确、图片域名已写入 next.config。部署到 Vercel 或其他 Node 环境后,再抽查一条真实 slug 和一条不存在的 slug。