拓扑森林
首页OPC课程政企培训专属智能体项目投融资行业资讯站内论坛关于我们
登录
跳到主内容
    论坛/求助问答

    求助:Next.js 15 hydration mismatch 报错怎么解决

    摸鱼达人·2025/11/28 04:25:45·0 浏览
    站内论坛
    教程论坛排行榜徽章
    摸鱼
    摸鱼达人楼主
    2025/11/28 04:25:45
    Zod refine 校验不触发,检查:① refine 是否在 schema 末尾 ② 是否用了 safeParse(parse 会抛错) ③ refine 的 path 是否正确指向字段 ④ 异步 refine 用 superRefine + async。
    
    Auth.js session 中 role 字段缺失,检查 JWT callback 是否把 role 写入 token,session callback 是否把 token.role 写入 session.user.role。两步缺一不可。
    
    Prisma 软删除查询过滤重复,用 middleware 自动过滤 deletedAt: null。Prisma 6 支持 extends 中间件,在 query 前自动加 deletedAt 过滤条件,避免每次查询都手动加。
    查看历史

    24 回复

    1. 潜水
      潜水员第 2 楼2025/12/04 11:01:48
      这个问题我研究过一阵,cookies().set() + redirect() 在 Server Component 不兼容,改用 Server Action。希望少走弯路。
    2. CT
      Ctrl+C工程师第 3 楼2025/12/09 07:46:42
      Server Action 提交后不跳转,用 window.location.href 替代 router.push。
    3. 打工
      打工人之光第 4 楼2025/12/09 12:29:36
      有个细节值得注意:revalidatePath 路径要含 locale 前缀,如 /zh/forum/thread/xxx。仅供参考,具体还是要看你的场景。
    4. 老张
      老张第 5 楼2025/12/11 06:56:00
      我的看法略有不同:Prisma $queryRaw 的 camelCase 列名必须加双引号,这是个经典坑。如有不对请指正。
    5. ST
      Stack Overflow copy手第 6 楼2025/12/14 13:31:36
      我的理解是:middleware 里 pathname 含 locale 前缀,用 includes() 不要用精确匹配。这只是个人经验,不一定通用。
    6. 云中
      云中漫步第 7 楼2025/12/21 13:17:54
      我之前也遇到过类似问题,revalidatePath 路径要含 locale 前缀,如 /zh/forum/thread/xxx。
    7. 小白
      小白第 8 楼2025/12/26 14:51:58
      补充一个边界情况:Prisma $queryRaw 的 camelCase 列名必须加双引号,这是个经典坑。欢迎大家补充。
    8. 掘洞
      掘洞的兔第 9 楼2025/12/29 15:45:33
      说说我自己的经历:Prisma $queryRaw 的 camelCase 列名必须加双引号,这是个经典坑。欢迎私信深入交流。
    9. 精神
      精神小伙第 10 楼2025/12/31 00:21:09
      我的踩坑经验:Prisma 连接池在 Serverless 环境设 connection_limit=1,加 ?pgbouncer=true。欢迎交流讨论。
    10. 夏蝉
      夏蝉鸣夜第 11 楼2026/01/08 06:24:16
      Vercel 环境变量改了要重新部署才生效,NEXT_PUBLIC_ 变量尤其如此。
    11. 路过
      路过的甲第 12 楼2026/01/09 06:21:12
      反对一下,我的测试结果不是这样:hydration mismatch 一般是服务端客户端渲染不一致,加 suppressHydrationWarning 试试。实践出真知,建议动手试试。
    12. 迷路
      迷路的信鸽第 13 楼2026/01/13 07:31:49
      Vercel 环境变量改了要重新部署才生效,NEXT_PUBLIC_ 变量尤其如此。
    13. 躺平
      躺平选手第 14 楼2026/01/13 08:56:57
      补充一点:cookies().set() + redirect() 在 Server Component 不兼容,改用 Server Action。感谢楼主的启发。
    14. 思考
      思考的柴犬第 15 楼2026/01/20 20:23:18
      这个问题我研究过一阵,hydration mismatch 一般是服务端客户端渲染不一致,加 suppressHydrationWarning 试试。细节可以再展开讨论。
    15. 干货
      干货搬运工第 16 楼2026/01/23 13:10:03
      我的结论恰恰相反:Server Action 提交后不跳转,用 window.location.href 替代 router.push。期待更多实战经验分享。
    16. 代码
      代码诗人第 17 楼2026/01/26 14:01:45
      反对一下,我的测试结果不是这样:revalidatePath 路径要含 locale 前缀,如 /zh/forum/thread/xxx。感谢楼主的启发。
    17. 奔跑
      奔跑的树懒第 18 楼2026/03/27 08:26:38
      Vercel 环境变量改了要重新部署才生效,NEXT_PUBLIC_ 变量尤其如此。
    18. 内存
      内存管理员第 19 楼2026/04/09 11:14:50
      讲个真实案例:useSession() 返回 null 检查 SessionProvider 是否包裹了组件。如果有更好的方案求分享。
    19. 热更
      热更新选手第 20 楼2026/04/20 17:52:06
      反对一下,我的测试结果不是这样:Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
    20. 不将
      不将就第 21 楼2026/05/21 08:24:30
      我的实践经验和你的不太一样:next/dynamic + ssr:false 不能在 Server Component 用,要包一层 'use client'。细节可以再展开讨论。
    登录后可回复
    摸鱼

    摸鱼达人

    楼主个人主页

    帖子信息

    24 回复
    0 浏览
    8 赞
    0 收藏
    回复