在 Debian 上排查与修复 JavaScript 错误的实用流程
一、快速定位与查看日志
- 前端页面：在浏览器按 F12 打开开发者工具，查看 Console 获取错误类型、消息、文件名与行号；在 Sources 面板设置断点、单步执行、观察调用栈与变量状态。
- Node.js 应用：在终端直接查看运行输出；或使用 node --inspect-brk app.js 启动调试，在 chrome://inspect 连接并断点调试；也可在 VS Code 配置 .vscode/launch.json 进行图形化调试。
- Web 服务器环境：查看 /var/log/ 下的服务日志，如 /var/log/apache2/error.log（Apache）、/var/log/nginx/error.log（Nginx）、或 /var/log/syslog（系统日志）；使用 tail -f /var/log/nginx/error.log 实时跟踪最新错误。
- 关键字检索：在日志中搜索 ERROR、Exception、Failed 等关键词，并结合时间戳定位上下文。
二、常见错误类型与修复要点
| 错误类型 |
典型触发 |
修复建议 |
| SyntaxError |
缺少括号/引号、非法字符 |
使用 ESLint/Prettier 检查语法，修正括号、引号、分号等配对问题 |
| ReferenceError |
使用未声明变量 |
在使用前用 var/let/const 声明，或检查作用域与依赖加载顺序 |
| TypeError |
读取 undefined/null 的属性 |
增加空值判断（如可选链 ?.、条件判断），确保对象已初始化 |
| RangeError |
参数越界（如负数长度数组） |
校验输入与边界条件，避免非法数值 |
| Maximum call stack size exceeded |
递归过深 |
改写为迭代、增加终止条件或尾递归优化 |
| module is not defined |
Node.js 模块引用不当 |
确认 require/import 路径与模块安装（npm/yarn），检查 package.json 依赖 |
| Unexpected token |
语法不兼容或构建产物损坏 |
确认 Babel/TypeScript 编译配置与目标环境一致，清理并重新构建 |
三、环境与兼容性问题处理
- 浏览器兼容：确保目标浏览器支持所用 ECMAScript 特性；必要时使用 Babel 转译、Polyfill 补齐 API。
- 浏览器版本：在 Debian 上通过包管理器更新浏览器（如 sudo apt update && sudo apt upgrade），避免旧版引擎导致的问题。
- 资源加载：核对
