0

0

React 中 useEffect 在开发模式下触发两次的原因及解决方案

碧海醫心

碧海醫心

发布时间:2026-01-05 19:01:02

|

830人浏览过

|

来源于php中文网

原创

React 中 useEffect 在开发模式下触发两次的原因及解决方案

react 开发模式下启用 strict mode 会导致 useeffect 模拟卸载/重挂载,从而执行两次;这是设计行为而非 bug,旨在帮助发现副作用清理问题。生产构建中不会出现此现象。

在 React(尤其是使用 App Router 的 Next.js 13+)中,你观察到 useEffect “执行两次”——例如倒计时结束时的清理逻辑被连续打印两次日志——这通常并非代码逻辑错误,而是 Strict Mode 的预期行为

Strict Mode 是 React 提供的开发辅助工具,它会在开发环境npm run dev)中对组件进行双渲染(double-invocation):即先挂载、渲染、执行副作用,再立即模拟卸载并重新挂载、渲染、再次执行副作用。其核心目标是提前暴露未正确清理的副作用(如未清除的定时器、未解绑的事件监听器、未取消的网络请求等)。

在你的倒计时示例中:

useEffect(() => {
  if (timer < 1 && timer != null) {
    setTimer(null);
    clearInterval(intervalId.current);
    console.log("proccccccccccccc"); // 这里被打印两次
  }
}, [timer]);

当 timer 降为 0 时,该 effect 触发。由于 Strict Mode 的双渲染机制,React 会:

  1. 第一次执行:检测到 timer
  2. 立即模拟卸载 → timer 变为 null(状态更新后);
  3. 再次挂载并执行 effect → 此时 timer 是 null,但 null 本应不执行。

⚠️ 但你加了 && timer != null 后反而“触发两次”,真实原因在于:null (因为 null 被强制转为 0,0

更根本的修复方式不是删条件,而是正确建模倒计时生命周期

✅ 推荐写法(健壮、可读、规避 Strict Mode 干扰):

'use client';
import { useState, useEffect, useRef } from 'react';

export default function Home() {
  const [timer, setTimer] = useState<number | null>(null);
  const intervalRef = useRef<NodeJS.Timeout | null>(null);

  const start = () => {
    setTimer(900);
  };

  // 启动定时器(仅在 timer 首次设为 900 时)
  useEffect(() => {
    if (timer === 900) {
      intervalRef.current = setInterval(() => {
        setTimer(prev => {
          if (prev === null || prev <= 1) {
            return null;
          }
          return prev - 1;
        });
      }, 1000);
    }

    // 清理函数:确保任何情况下都清除定时器
    return () => {
      if (intervalRef.current) {
        clearInterval(intervalRef.current);
      }
    };
  }, [timer]);

  // 倒计时结束处理(只在 timer 变为 null 时触发一次)
  useEffect(() => {
    if (timer === null) {
      console.log('Countdown finished!');
      // 执行完成逻辑(如弹窗、跳转等)
    }
  }, [timer]);

  return (
    <main className="p-4">
      <button onClick={start} disabled={timer !== null}>
        {timer === null ? 'Start Timer' : `Remaining: ${timer}s`}
      </button>
    </main>
  );
}

? 关键改进点:

  • 将 setInterval 和清理逻辑合并到单个 effect 中,并利用 return cleanup 确保资源释放;
  • 使用函数式更新 setTimer(prev => ...) 避免闭包旧值问题;
  • timer === null 作为完成标识,语义清晰且无类型歧义(避免 null 隐式转换陷阱);
  • 启动按钮禁用逻辑提升用户体验。

? 补充说明:

  • 若需临时关闭 Strict Mode(不推荐长期使用),可在 app/layout.tsx 或 src/index.js 中移除 包裹;
  • 生产构建(next build && next start)自动禁用 Strict Mode,因此该现象仅存在于开发环境,不影响线上行为。

遵循上述模式,你不仅能解决“执行两次”的困惑,更能写出符合 React 最佳实践、具备可维护性与鲁棒性的副作用逻辑。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1089

2024.03.01

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

334

2025.08.29

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

106

2025.10.23

go语言闭包相关教程大全
go语言闭包相关教程大全

本专题整合了go语言闭包相关数据,阅读专题下面的文章了解更多相关内容。

151

2025.07.29

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

530

2023.06.20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号