如何看懂报错信息:30秒读懂任何错误

如何看懂报错信息:你并没有卡住,只是还没看到错误。每当你用 AI 做的应用"莫名其妙"出问题,它都会把出错原因准确写进浏览器控制台。用一个快捷键打开控制台,读第一行和文件名,几乎任何错误你都能在 30 秒内看懂——不需要工程学位。

对用 AI 做产品的非技术创始人来说,这是杠杆最高的一项技能。不是因为你要自己修好每个错误,而是因为"坏了,帮帮我"和把确切的报错贴给 Claude 之间的差别,就是一小时的瞎猜和 30 秒的修复之间的差别。

如何打开浏览器控制台

控制台是网站的后台。如果你的应用是一场戏剧演出,控制台就是你能看到舞台工作人员、提示信号,以及某样东西倒下那一刻的地方。打开方法:

• Chrome:Mac 上按 Cmd + Option + J,Windows 上按 Ctrl + Shift + J——或者在页面任意位置右键,选择"检查",再点击"控制台"标签
• Firefox:Mac 上按 Cmd + Option + K,Windows 上按 Ctrl + Shift + K
• Safari:先启用"开发"菜单(设置、高级、"显示开发菜单"),再按 Cmd + Option + C

有两个标签最重要。Console(控制台)显示错误和日志——任何东西不工作时,先从这里看起。Network(网络)显示你的应用向服务器发出的每一个请求——登录失败或数据加载不出来时用它:刷新页面,找红色的行,点开一行查看详情。而且不,看一看不会弄坏任何东西。控制台默认是只读的。

如何看懂报错信息:错误的四个组成部分

报错信息看起来吓人,是因为它们是写给懂行话的开发者的。但它们有固定的结构,就像一份医学诊断——专业术语、确切位置,以及足够修好问题的信息。一共四个部分,顺序永远一样:

1. 错误类型。即类别:TypeError 表示你用错了东西,ReferenceError 表示你用了不存在的东西,SyntaxError 表示代码有拼写错误,NetworkError 表示应用连不上服务器。
2. 错误描述。一行话说明具体问题——"Cannot read property of undefined"意思是代码试图使用还不存在的数据。
3. 错误位置。文件名、行号和字符位置。这是最有用的部分:它告诉你该去哪里找。
4. 调用栈。导致错误的一连串函数调用。你通常只需关心前几行中提到你认识的文件的部分——其余都是内部库代码,可以忽略。

30 秒方法:读第一行,知道出了什么问题;找到第一个你认识的文件名,知道在哪里出的问题;忽略所有提到库内部的内容。

红、黄、灰:颜色代表什么

控制台按严重程度用颜色标记一切,这告诉你什么值得关注:

• 红色 = 错误。有东西当场坏了,应用无法继续。停下来修复。
• 黄色 = 警告。今天还能用,但以后可能出问题或性能变差。有空时再修——警告不会让你的应用停摆。
• 白色或灰色 = 信息。正常日志。有些库就是话多。忽略它们。

控制台里满是信息,并不一定是坏事。盯住红色的,记下黄色的,忽略其余的。

本书The Solopreneur RevolutionLuis Gonçalves 讲述如何在不辞职的情况下用 AI 打造独立创业者事业。获取本书 →

你真正会遇到的六种错误(逐一解读)

用 Claude、Supabase 等 AI 工具开发 SaaS 时,几乎所有问题都来自同样的那几种错误。下面是白话翻译:

状态码只遵循一条规则:200 开头表示成功,400 开头表示你做错了什么(数据有误、没登录、没权限、地址错误),500 开头表示服务器自己出了故障。就这一条规则,就能解读整个 Network 标签。

向 AI 求助时该贴什么

读懂报错的回报就在这里。把错误交给 Claude 时,答案的质量取决于你贴了什么。每次贴三样东西:

1. 完整的报错信息——包括文件名和行号,直接从控制台复制(右键点击信息,选择复制)
2. 错误周围的代码——报错所指那一行的前后各约五行
3. 你当时在做什么——一句话:"我登录后想加载个人资料页面"

有了这三样东西,AI 大多数错误一次就能修好。没有它们,AI 就只能猜——而一个在猜的 AI,正是让你陷入AI 自信地出错的迹象里所描述的那种烂摊子的原因。如果同一个错误反复出现,或者你遇到的是一个场景而不是单个错误,后续文章会带你看十个最常见的 AI 开发问题及其解决办法。

错误不是敌人。它们是应用在准确告诉你它需要什么。能把产品交付出去的创始人,不是从没见过红色文字的人,而是不再害怕它的人。

12 周企业职业生涯从来都不是计划申请加入 Solopreneur Accelerator。立即申请 →

常见问题

看懂报错信息需要懂代码吗?

不需要。你只需要认出四个部分——类型、描述、位置、调用栈——并准确复制它们。见过常见的那几种之后,错误类型和描述几乎就是白话,位置不过是一个文件名和一个行号。剩下的交给 AI。

使用浏览器控制台会弄坏我的应用吗?

不会。开发者工具默认是只读的——你是在后台看一看,而不是在重新布置舞台。你可以打开控制台、切换标签、复制信息,对你的应用和数据都没有任何风险。

应该先修哪些错误?

先修阻断核心流程的红色错误:网络错误、身份验证错误、数据库错误,以及任何导致白屏的问题。黄色警告可以等等。灰色信息日志完全不用处理——它们只是应用在讲述自己的一天。

如果控制台没有报错,应用却仍然不对劲怎么办?

去 Network 标签找红色的行——请求失败并不总会在控制台抛出可见的错误。如果网络也一切正常,那很可能是数据被过滤掉了,而不是失败了:账户不对、记录未启用,或者带着草稿标记。这种情况和另外九种情况,都在常见 AI 开发问题指南里解读过。