
在 React 开发模式下,useEffect 会因组件被故意重复挂载而执行两次——这是框架为检测副作用不纯性所设的保护机制,并非 Bug;正确做法是让副作用具备可重入性,而非强行限制执行次数。
在 react 开发模式下,`useeffect` 会因组件被故意重复挂载而执行两次——这是框架为检测副作用不纯性所设的保护机制,并非 bug;正确做法是让副作用具备可重入性,而非强行限制执行次数。
React 在开发环境(StrictMode 启用时)会对函数组件执行双挂载(double mount):即组件首次挂载 → 立即卸载 → 再次挂载。这一行为旨在暴露那些未正确清理、依赖外部状态或不具备幂等性的副作用逻辑。你观察到的“两次认证请求”,正是该机制触发的结果——useEffect 中的 initialize() 被执行了两次,而 getTokenAndSaveToSession() 若未做防重入处理,就会向 Salesforce Marketing Cloud 发起重复授权请求,导致第二次失败(因 OAuth code 一次性有效)。
✅ 正确解决思路:确保副作用幂等 & 安全清理
你不应试图“阻止第二次执行”(如加全局 flag 或 localStorage 锁),而应让整个流程天然支持重复调用:
-
检查 token 是否已存在:在发起新请求前,优先读取
sessionStorage; -
避免重复使用已消费的 code:
params.code仅在首次存在时有效,二次执行时应跳过认证流程; - (可选)添加清理逻辑:若认证过程涉及定时器、事件监听或未完成的 Promise,应在 cleanup 函数中中止。
以下是优化后的代码示例:
使用 assistant-ui 构建具有可重用线程、运行时、消息组件和模型/提供者适配器的生产级 React 聊天界面。
useEffect(() => {
let isMounted = true; // 防止异步回调时组件已卸载
async function initialize() {
// 1. 优先检查已有 token
const existingToken = sessionStorage.getItem('token');
if (existingToken) {
console.log('Token already exists, skipping auth flow');
await fetchJourneyData();
return;
}
const params = await getParamsFromUrl();
// 2. 仅当 code 存在且 token 不存在时才执行认证
if (params.code) {
try {
await getTokenAndSaveToSession(params.code);
if (isMounted) await fetchJourneyData();
} catch (error) {
console.error('Authentication failed:', error);
}
} else {
console.log('No authorization code found in URL');
}
}
initialize();
// 清理函数:防止内存泄漏或状态错乱
return () => {
isMounted = false;
};
}, []); // 依赖数组为空,确保仅在挂载/卸载时响应
async function getTokenAndSaveToSession(code: string) {
try {
const authService = new AuthService();
const result = await authService.getToken(code);
sessionStorage.setItem('token', result.token);
sessionStorage.setItem('expiration', result.expiration.toString());
} catch (error) {
console.error('Failed to exchange code for token:', error);
throw error;
}
}
⚠️ 关键注意事项
-
不要依赖
useEffect执行次数:生产环境只执行一次,开发环境两次,行为不一致;业务逻辑必须对两种场景均健壮。 -
code是一次性凭证:Salesforce Marketing Cloud 的 OAuth 流程中,code使用后立即失效,重复提交将返回invalid_grant错误——因此必须通过sessionStorage或类似机制做前置校验。 -
StrictMode不影响生产构建:该机制仅存在于开发环境,上线后自动关闭,无需额外兼容。 - 避免副作用污染渲染逻辑:认证应视为初始化副作用,而非渲染条件;UI 层可通过 loading 状态或 token 有效性来控制展示,而非阻塞 effect。
遵循上述原则,你的认证流程将同时满足开发调试安全性与生产运行稳定性,真正实现“一次配置、处处可靠”。










