JavaScript 常见报错类型、原因分析与处理指南

作者:函数茶馆时间:2026-10-24 06:33:33浏览:141

本文系统梳理了 JavaScript 开发中常见的报错类型,包括 RangeError、ReferenceError、SyntaxError 和 TypeError 等。详细解析了最大调用栈、变量未定义、语法标记无效、属性访问错误等典型报错的原因,并提供了递归终止、变量声明、逻辑运算符短路及 try/catch 等实用处理方案,帮助开发者快速定位并解决控制台红色报错。

引言

在 Web 开发过程中,开发者常遇到耗时编写的 JavaScript 代码在浏览器控制台报出一堆红色错误,令人头疼。本文旨在整理 JavaScript 中常见的报错类型及其对应的错误信息,深入分析报错原因,并提供相应的处理建议。此外,还将介绍几种捕获和处理异常的有效方法。

常见错误类型概览

常见的错误类型

RangeError:当数值超出允许范围时触发的错误。例如,创建数组时指定负数长度:new Array(-20)。

ReferenceError:引用错误,当尝试访问一个不存在的变量时发生。例如:console.log(a)。

SyntaxError:语法错误,代码不符合 JavaScript 语法规则。例如:if(true) { 缺少闭合大括号。

TypeError:类型错误,当值的类型与预期不符时发生。

常见报错详解与处理

常见的错误

RangeError: Maximum call stack size exceeded

含义:超出了最大的堆栈大小

为什么报错?

在使用递归时消耗大量堆栈,导致浏览器抛出错误,因为浏览器分配的内存不是无限的。

举个栗子


function pow(x, n) {
 return x * pow(x, n - 1);
}
pow(10,5);

处理办法

使用递归的时候,设定一个条件来终止递归,否则会无限循环,直到用尽调用堆栈空间为止。


function pow(x, n) {
  if (n == 1) return x;
  return x * pow(x, n - 1);
 }
pow(10,5);

ReferenceError: "x" is not defined

含义:“x”未定义

为什么报错?

当你引用一个没有定义的变量时,抛出一个ReferenceError; 当你使用变量的时候,这个变量必须要声明,或者你可以确保它在你当前的脚本或作用域 (scope) 中可用。

举个栗子


// 变量未声明
console.log(a);
fn();
// 错误的作用域  
function sum() {
 let number1 = 20,number2 = 30;
 return number1 + number2;
}
console.log(number1);

处理办法

1. 变量使用var|let|const声明

2. 提升变量的作用域


// 变量未声明
let a;
function fn() {};
console.log(a);
fn();

// 错误的作用域
let number1 = 20, number2 = 30;
function sum() {
  return number1 + number2;
}
console.log(number1);

SyntaxError: Identifier 'x' has already been declared

含义: 标识符已声明

为什么报错?

某个变量名称已经作为参数出现了,又在使用let再次声明。

举个栗子


// let 重复声明
let a = 0;
let a = 2;

// 在函数中参数已经出现,函数里使用let重新声明
function fn(arg) {
 let arg = [];
}

SyntaxError: Invalid or unexpected token

含义:捕获无效或意外的标记

为什么报错?

代码中有非法的字符或者缺少必要的标识符号,比如减号 ( - ) 与连接符 ( – ) ,或者是英文双引号 ( " ) 与中文双引号 ( “ )。

举个栗子


// 遗漏的字符
let str = 'string;
let colors = ['#000', #333', '#666'];

// 使用特殊字符
let str1 = 'string";
let str2 = 5#5;

// 错配字符(使用中文引号字符)
let str3 = ‘string';

处理办法

检查是否有特殊字符或者是否遗漏一些字符。

SyntaxError: Unexpected end of input

含义:意外的终止输入

为什么报错?

代码中某些地方的括号或引号不匹配缺失,缺少()、[]、{}等。

举个栗子


// 缺少括号
if(true)
let obj = {id: 1
let arr = [1,2,3


// 缺少结束符号
(function () {
  console.log('hello world');
}()

处理办法

检查是否有特殊字符或者是否遗漏一些字符,括号需要配对出现。

TypeError: Cannot read property 'x' of undefined TypeError: Cannot set property 'x' of undefined

含义:无法读取属性‘x', 无法设置属性 'x'

为什么报错?

访问或设置未定义(undefined)或null值的属性时会发生这种报错。

举个栗子


// undefined
let a = undefined;
a.id; // 读取
a.id = 1; // 设置
// null
let b = null;
b.id; // 读取
b.id = 2; // 设置
null.filter(item=>item)

处理办法

有一些方法可以避免这种错误。一种简单且适用于小型属性链的方法是使用逻辑运算符&&。


let obj = undefined;
console.log(obj&&obj.id);

TypeError: 'x' is not a constructor

含义:表示 ‘x'不是构造函数

为什么报错?

使用不是构造器的对象或者变量来作为构造器使用。比如:new 10;

举个栗子


var Car = 1;
new Car();
new Math();

处理办法

使用正确的构造函数。Generator functions 也不能作为构造器来使用。


function Car(make, model, year) {
 this.make = make;
 this.model = model;
 this.year = year;
}

SyntaxError: Invalid regular expression flags

含义:正则表达式标志无效

为什么报错?

在代码中出现了无效的正则表达式的标记。

举个栗子


let reg = /foo/bar;

处理办法


let reg = /foo/bar;

DOMException: Failed to execute 'open' on 'XMLHttpRequest': Invalid URL

含义:无效的Url

为什么报错?

在使用ajax 请求时url错误,导致请求失败

举个栗子


function createXHR(url) {
  var xhr = new XMLHttpRequest();
  xhr.open('POST', url, true);
  xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
  xhr.send('user=admin');
  xhr.onreadystatechange = function () {
  }
}
createXHR('http://192.168.10.8080'); // 错误url
createXHR('http:/192.168.10:8080/open'); // 缺少 /,注:有些游览器会自动补全

处理办法

检查url 请求是否正确,保证请求路径的完整。


createXHR('http://192.168.10:8080');

异常调试及捕获方法

异常调试及捕获

try/catch

JS中处理异常的一种模式,try用于可能会发生错误的代码,catch对错误的处理


try{
 // 可能会导致错误的代码
}catch(error) {
 // 错误处理
}

举个栗子


try{
 console.log(a)
}catch(error) {
  // 打印错误信息
 console.log(error); // ReferenceError: a is not defined
}

throw

用来抛出一个用户自定义的异常,执行将被停止。


function getUserName(name) {
  if(!name) throw new Error('用户名无效');
  return name;
}
getUserName();

Promise 的异常处理

Promise执行中,本身自带try...catch的异常处理,出错时,将错误Rejact函数。


new Promise((resolve, reject) => {
 throw new Error('error!');
}).catch(alert);

console.log() 方法

在游览器中,使用console.log打印javaScript的值。


let value = '你最棒了,点个赞呗!'
console.log(value);

debugger 断点调试

用于停止执行 JavaScript,并调用调试函数。


let value = 15;
debugger
document.querySelector('body').innerHTML = '你最棒了,点个赞呗!'

总结

总结

报错就是那么简单,根据这些代码敲一敲,熟悉一些常用的报错信息,便于在报错的时候快速地定位到报错原因。希望对可爱的你有用。

到此这篇关于再也不怕 JavaScript 报错了,怎么看怎么处理都在这儿的文章就介绍到这了,更多相关javascript报错处理内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

作者最新文章