作品分享：Next.js 项目里程碑追踪器，甘特图

溪畔

2025/12/22 03:01:22

性能数据分享一下：PageSpeed 移动端 98 分，桌面端 100 分。LCP 0.9s，INP 86ms，CLS 0.02。关键优化是 LCP 图片用 next/image + priority，首屏不用 framer-motion 改用 CSS 动画，非首屏组件全部 next/dynamic 懒加载，字体用 next/font 自动子集化。

技术架构上，Server Component 做数据获取和 SEO 输出，Client Component 只负责交互。用 Server Action 处理表单提交，Zod 校验输入，错误消息走 next-intl i18n。认证用 Auth.js 5 JWT 模式，中间件做认证重定向和 API 限流。

部署流程：GitHub push → Vercel 自动构建 → Preview 环境 → 合并到 main → Production 环境。环境变量在 Vercel Dashboard 配置，区分 Production/Preview/Development。数据库迁移用 GitHub Actions 在部署前自动执行 prisma migrate deploy。

这个项目的 Admin 后台是独立认证体系，HMAC-SHA256 签名 session，和前台 Auth.js 完全隔离。Admin 路由在 (admin) 路由组内，独立的 layout 和 error boundary。Admin Actions 和前台 Actions 分文件存放，不混用认证方式。

性能对比：ISR vs SSR vs SSG。我的选择是公共页面用 ISR（revalidate: 3600），用户页面用 SSR（个性化数据），认证页面用 SSG（表单页）。ISR 缓存安全要确保 SSR 输出对所有用户相同，不含 session 数据。

查看历史

65 回复

无所

无所谓第 2 楼2025/12/23 05:14:47

不同场景下结论可能不同：Recharts 用 next/dynamic 懒加载是对的，我之前直接 import 导致首屏 LCP 从 1s 变成 3s。一起学习。

拾光

拾光者第 3 楼2025/12/23 11:43:34

我的项目里也用了这个方案，三天上线太强了，我做类似的项目用了一周，AI 生成代码的比例和你差不多也是 70% 左右。踩了很多坑才总结出来的。

赛博

赛博修行者第 4 楼2025/12/24 10:05:16

我调研过这块，Yjs 实时协作的方案很完整，但 Vercel Edge Runtime 上跑 WebSocket 会不会有连接数限制？细节可以再展开讨论。

摸鱼

摸鱼达人第 5 楼2025/12/27 07:56:56

结合我最近的项目经验：Auth.js JWT trigger === 'update' 这个坑我也踩过，session 不刷新真的很难排查。希望少走弯路。

007志愿者第 6 楼2025/12/27 08:34:06

有个更优的方案：ISR + MDX 的博客方案我也在用，revalidate: 3600 是个合理的值，太短会影响性能。踩了很多坑才总结出来的。

后端

后端搬砖工第 7 楼2025/12/30 19:16:04

我的实践经验和你的不太一样：多租户 SaaS 架构能展开讲讲吗？特别是数据隔离是按 schema 还是按 tenantId 字段？有疑问可以继续问。

精神

精神小伙第 8 楼2025/12/31 01:11:37

我的实践经验和你的不太一样：Stripe Webhook 集成那段很有参考价值，金额用整数（分）这个细节很多人会忽略。踩了很多坑才总结出来的。

林间

林间晨露第 9 楼2025/12/31 23:04:58

讲个真实案例：暗色模式用 next-themes 确实方便，我的项目也是这么做的，但要注意 suppressHydrationWarning。效果因项目而异，建议实际测试。

全栈

全栈探险家第 10 楼2026/01/01 12:07:30

这个方案我试过，这个项目技术栈和我现在做的很像，PageSpeed 98 分确实不容易，我的才 85 分需要优化了。后续有新发现再来更新。

老张

老张第 11 楼2026/01/03 01:39:28

我调研过这块，Recharts 用 next/dynamic 懒加载是对的，我之前直接 import 导致首屏 LCP 从 1s 变成 3s。希望少走弯路。

星辰

星辰大海第 12 楼2026/01/04 06:33:09

上周刚好踩了这个坑，Server Component 和 Client Component 边界划得很清晰，我之前总是搞混导致 hydration 报错。希望少走弯路。

代码

代码诗人第 13 楼2026/01/04 08:38:02

这个项目技术栈和我现在做的很像，PageSpeed 98 分确实不容易，我的才 85 分需要优化了。

春暖

春暖花开第 14 楼2026/01/04 09:29:39

补充一个可能被忽略的点：Stripe Webhook 集成那段很有参考价值，金额用整数（分）这个细节很多人会忽略。仅供参考，具体还是要看你的场景。

潜水

潜水员第 15 楼2026/01/10 13:50:26

不同场景下结论可能不同：300 注册用户日活 50，留存率不错了，我的产品日活只有注册的十分之一，求教运营经验。共同进步。

干货

干货搬运工第 16 楼2026/01/11 02:38:45

我的团队是这样做的：300 注册用户日活 50，留存率不错了，我的产品日活只有注册的十分之一，求教运营经验。我也还在探索中。

蜕皮

蜕皮的蛇第 17 楼2026/01/11 10:14:31

我的结论恰恰相反：ISR + MDX 的博客方案我也在用，revalidate: 3600 是个合理的值，太短会影响性能。一起学习。

雾里

雾里看花第 18 楼2026/01/12 16:02:44

讲个真实案例：Auth.js JWT trigger === 'update' 这个坑我也踩过，session 不刷新真的很难排查。踩了很多坑才总结出来的。

搬家

搬家的蚂蚁第 19 楼2026/01/15 05:25:27

有个更优的方案：暗色模式用 next-themes 确实方便，我的项目也是这么做的，但要注意 suppressHydrationWarning。欢迎交流讨论。

隔壁

隔壁老王第 20 楼2026/01/16 01:58:43

作品完成度很高，LCP 0.9s 的数据很亮眼，请问 next/image 的 priority 是只给首屏大图加了吗？

差不

差不多第 21 楼2026/01/17 05:50:40

这个项目技术栈和我现在做的很像，PageSpeed 98 分确实不容易，我的才 85 分需要优化了。