在 node.js 的 express 应用中，若将变量声明在请求处理函数外部（如模块顶层），该变量会成为模块级全局状态，在整个服务生命周期内持续存在，导致多次请求共享同一值——这是状态意外累积的根本原因。
在 node.js 的 express 应用中，若将变量声明在请求处理函数外部（如模块顶层），该变量会成为模块级全局状态，在整个服务生命周期内持续存在，导致多次请求共享同一值——这是状态意外累积的根本原因。
在你提供的代码中，let box = 0; 被定义在控制器模块的顶层作用域（即 export const index = ... 之外），这意味着：
- 该变量在模块首次加载时初始化一次；
- 后续所有 HTTP 请求都复用同一个 box 实例；
- 每次调用 box++ 实际是在修改这个持久存在的内存变量，因此刷新浏览器时数值持续递增（1 → 2 → 3…）。
✅ 正确做法：将状态变量声明在请求处理函数内部，确保每次请求都拥有独立的作用域和初始值：
import { Request, Response } from "express";
import axios from "axios";
import { parseString } from "xml2js";
export const index = (req: Request, res: Response) => {
let box = 0; // ✅ 局部变量：每次请求新建、独立生命周期
box++;
res.json({ box }); // 推荐使用 res.json() 替代 res.send(JSON.stringify(...))
};
⚠️ 注意事项：
- 切勿在模块顶层存储请求级状态（如计数器、临时数据、用户上下文等），除非你明确需要跨请求共享（如缓存、配置、单例服务）；
- 若需持久化状态（如统计总请求数），应使用外部存储（Redis、数据库）或线程安全的共享对象（配合锁机制），而非简单全局变量；
- TypeScript 不会阻止此类逻辑错误，需开发者主动识别作用域边界；
- 在 npm run watch-node 热重载环境下，模块可能被反复重新加载，但只要服务未完全重启，全局变量仍可能保留（尤其使用 require.cache 时），进一步加剧调试困惑。
总结：Node.js 是单进程多请求模型，模块仅加载一次。理解 JavaScript 作用域与模块生命周期，是避免“变量不重置”类问题的关键。始终优先使用局部变量处理请求独有数据，让状态归属清晰、可预测、易测试。
