已定义变量触发ReferenceError错误——JavaScript词法声明初始化前访问问题排查

开发者阿泽

2026-4-28

问题根源：Switch块作用域 + Let的暂时性死区（TDZ）

你遇到的这个坑，本质是**JavaScript中let的暂时性死区（Temporal Dead Zone）**结合switch语句的块作用域特性导致的，不算特别晦涩，但确实很容易踩中。

具体原因拆解

咱们一步步看你的代码：

函数开头你在函数作用域声明了let msg = JSON.parse(json);，前面四次console.log访问的都是这个变量，所以一切正常。
问题出在case "welcome"里的let msg = { "type":"game list", "data":null };——注意：switch的所有case分支都共享同一个大括号包裹的块作用域，这个let msg声明属于整个switch块，会直接遮蔽外层函数作用域的msg变量。
根据ES6的规则，let变量的声明会被提升到所在块的顶部，但不会被初始化。在声明语句（也就是let msg = {...}）执行之前，变量处于暂时性死区，任何访问都会抛出你看到的那个引用错误。
当代码处理"game list"类型的消息时，进入对应的case分支，此时它会尝试访问switch块里的msg（因为被遮蔽了），但这个变量的初始化只有在走"welcome"分支时才会执行，当前分支根本没走到那一步，所以变量还在TDZ里，直接触发错误。

修复方案

有两种简单的解决办法：

方案1：改用不同的变量名
避免在switch块里声明和外层同名的变量，比如把发送用的变量改成outgoingMsg：

case "welcome": 
  console.log("Welcome received. Requesting available games."); 
  let outgoingMsg = { "type":"game list", "data":null }; 
  ws.send(JSON.stringify(outgoingMsg)); 
  break;

方案2：给case添加独立的块作用域
给每个case分支加上大括号，让case里的let变量只属于当前分支的块，不会影响其他case：
```
case "welcome": {
  console.log("Welcome received. Requesting available games.");
  let msg = { "type":"game list", "data":null };
  ws.send(JSON.stringify(msg));
  break;
}
```
这样这个msg就被限制在这个case的块里，其他case依然访问外层函数作用域的msg，完全避开TDZ问题。