AI的提示词专栏：错误定位 Prompt，快速定位异常堆栈

AI的提示词专栏：错误定位 Prompt，快速定位异常堆栈

本文聚焦错误定位 Prompt 的设计与应用，先阐释异常堆栈的核心构成及开发者定位错误时的信息过载、经验依赖等痛点，明确错误定位 Prompt 需实现信息提取、根因推测、行动指南三大目标。接着分别给出适用于新手的基础模板与面向资深开发者的进阶模板，结合 Python 索引越界、微服务订单创建错误等案例展示模板实战效果。还介绍了针对 Java、Python、JavaScript 等多语言及数据库、分布式链路等特殊场景的 Prompt 适配技巧，提出通过约束输出细节、添加负面清单、示例引导优化模型输出的方法，最后以章节总结和含思路点拨的课后练习巩固知识，助力开发者借助 Prompt 高效定位不同场景下的程序错误。

人工智能专栏介绍

    人工智能学习合集专栏是 AI 学习者的实用工具。它像一个全面的 AI 知识库，把提示词设计、AI 创作、智能绘图等多个细分领域的知识整合起来。无论你是刚接触 AI 的新手，还是有一定基础想提升的人，都能在这里找到合适的内容。从最基础的工具操作方法，到背后深层的技术原理，专栏都有讲解，还搭配了实例教程和实战案例。这些内容能帮助学习者一步步搭建完整的 AI 知识体系，让大家快速从入门进步到精通，更好地应对学习和工作中遇到的 AI 相关问题。

    这个系列专栏能教会人们很多实用的 AI 技能。在提示词方面，能让人学会设计精准的提示词，用不同行业的模板高效和 AI 沟通。写作上，掌握从选题到成稿的全流程技巧，用 AI 辅助写出高质量文本。编程时，借助 AI 完成代码编写、调试等工作，提升开发速度。绘图领域，学会用 AI 生成符合需求的设计图和图表。此外，还能了解主流 AI 工具的用法，学会搭建简单智能体，掌握大模型的部署和应用开发等技能，覆盖多个场景，满足不同学习者的需求。

1️⃣ ⚡ 点击进入 AI 的提示词专栏，专栏拆解提示词底层逻辑，从明确指令到场景化描述，教你精准传递需求。还附带包含各行业适配模板：医疗问诊话术、电商文案指令等，附优化技巧，让 AI 输出更贴合预期，提升工作效率。

2️⃣ ⚡ 点击进入 AI 灵感写作专栏，AI 灵感写作专栏，从选题到成稿，全流程解析 AI 写作技巧。涵盖论文框架搭建、小说情节生成等，教你用提示词引导 AI 输出内容，再进行人工润色。附不同文体案例，助你解决写作卡壳，产出高质量文本。

3️⃣ ⚡ 点击进入 AI 辅助编程专栏，AI 辅助编程专栏，通过实例教你用 AI 写代码：从功能描述到调试优化。涵盖前端、后端、数据库等，语言包括HTML5、VUE、Python、Java、C# 等语言，含算法实现、Bug 修复技巧，帮开发者减少重复劳动，专注核心逻辑，提升开发速度。

4️⃣ ⚡ 点击进入 AI 精准绘图专栏，AI 精准绘图，聚焦 AI 绘图在设计场景的落地。详解如何描述风格、元素、用途，生成 logo、商标等。含 Midjourney 等工具参数设置，及修改迭代方法，帮设计新手快速出图，满足商业与个人需求。

5️⃣ ⚡ 点击进入 AI 绘制图表专栏，AI 绘制图表专栏，教你用 AI 工具将数据转化为直观图表。涵盖曲线图数据输入、流程图逻辑梳理等，附 Excel 联动、格式美化技巧，适合学生、职场人快速制作专业图表，提升数据展示效果。

6️⃣ ⚡ 点击进入 AI 的工具集专栏，AI 的工具集专栏，盘点主流 AI 工具：ChatGPT、DeepSeek、 Claude、Gemini、Copilot 等。解析各工具优势，附使用场景与技巧，帮你根据需求选工具，快速上手提升效率，覆盖办公、创作、开发等场景。

7️⃣ ⚡ 点击进入 AI 的智能体专栏，AI 的智能体专栏，解析智能体自主运行原理，包括任务拆解、环境交互等。教你用大模型搭建简单智能体，附多智能体协作案例，适合想探索 AI 自主系统的开发者入门。

8️⃣ ⚡ 点击进入 AI 的大模型专栏，AI 的大模型专栏，详解大模型部署步骤，从本地搭建到云端部署。含 API 调用教程、应用开发案例，教你将大模型集成到项目，掌握企业级 AI 应用开发技能，应对实际业务需求。

一、章节引言：为什么错误定位需要专门的 Prompt？

在软件开发流程中，错误定位是开发者日常工作的核心环节之一，也是消耗时间与精力的关键痛点。当程序抛出异常时，开发者往往需要面对冗长的堆栈信息、零散的日志片段，甚至在复杂系统（如微服务架构、分布式应用）中，错误根因可能横跨多个服务、涉及不同层级的代码调用，导致定位效率低下。

传统错误定位依赖开发者的经验：手动梳理堆栈层级、检索相关代码文件、排查输入输出数据，整个过程不仅对新手不友好，即使是资深开发者，面对陌生项目或复杂异常时也容易陷入“试错式排查”的困境。而错误定位 Prompt 则能通过精准的指令设计，引导大语言模型（LLM）像“虚拟调试助手”一样，自动解析堆栈信息、识别关键错误线索、关联代码逻辑，并输出结构化的定位建议，大幅缩短排查周期。

例如，当开发者仅粘贴一段 Java 空指针异常（NullPointerException）的堆栈日志时，普通提问可能仅得到“检查对象是否初始化”的泛泛建议；而经过优化的错误定位 Prompt 能进一步要求模型：标注堆栈中的关键调用层级、推测可能引发空指针的代码场景、给出具体的排查步骤（如查看某行代码的对象赋值逻辑），甚至生成调试代码片段。

本章将从错误定位的核心痛点出发，系统讲解错误定位 Prompt 的设计逻辑、不同场景下的模板构建、模型输出优化技巧，并结合多语言（Java、Python、JavaScript）、多架构（单体应用、微服务）的实战案例，帮助读者掌握“用 Prompt 高效定位错误”的能力。

二、核心概念：错误定位与异常堆栈的基础认知

在设计 Prompt 前，需先明确错误定位的核心要素——异常堆栈的结构与关键信息，这是 Prompt 指令能精准引导模型的前提。

2.1 什么是异常堆栈？

异常堆栈（Exception Stack Trace）是程序抛出异常时，运行时环境（如 JVM、Python 解释器、Node.js 引擎）生成的“调用轨迹记录”，它包含了异常类型、错误消息、代码调用链路三大核心信息，是定位错误的“原始证据”。

以 Python 的 IndexError 为例，一段典型的异常堆栈如下：

Traceback (most recent call last): File "user_manage.py", line 25, in get_user_info return users[index] # 第25行：尝试访问列表越界的索引 File "main.py", line 18, in <module> user = get_user_info(5) # 第18行：调用get_user_info函数，传入index=5 IndexError: list index out of range # 异常类型：列表索引越界 

从堆栈中可提取的关键信息：

• 异常类型：IndexError（明确错误类别，如空指针、索引越界、语法错误等）；
• 错误消息：list index out of range（描述错误具体原因）；
• 调用链路：从顶层调用（main.py 第18行）到错误发生点（user_manage.py 第25行）的完整代码路径；
• 错误位置：精确到文件、行号（便于直接跳转代码）。

2.2 错误定位的核心痛点（Prompt 需解决的问题）

开发者在手动定位错误时，常面临以下问题，而这些正是 Prompt 设计需针对性解决的目标：

2.3 错误定位 Prompt 的核心目标

一个高质量的错误定位 Prompt，需实现以下 3 个核心目标，确保模型输出具备实用性、精准性、可操作性：

1. 信息提取：从混乱的堆栈日志中，自动提取异常类型、错误位置、关键调用链路；
2. 根因推测：结合代码上下文（如函数功能、输入数据），推测 2-3 个最可能的错误根因（避免泛泛而谈）；
3. 行动指南：给出 step-by-step 的排查步骤，甚至生成调试代码片段（如打印关键变量、添加日志）。

三、错误定位 Prompt 的设计框架：从基础到进阶

错误定位 Prompt 的设计需遵循“信息引导 + 约束输出 + 场景补充”的逻辑，根据开发者的经验水平（新手/资深）、错误场景（单体/微服务），分为“基础模板”和“进阶模板”两类。

3.1 基础模板：面向新手，覆盖单一语言/单体应用

基础模板适用于单体应用、单一语言（如 Python/Java）、无复杂上下文的错误场景，核心是“降低输入门槛”——开发者只需粘贴堆栈日志，模型即可输出结构化的定位建议。

基础模板结构（通用版）

# 角色与任务 你是一位资深软件开发调试助手，擅长[指定语言，如Python/Java/JavaScript]的错误定位。请基于我提供的异常堆栈日志，完成以下任务： # 输入信息 异常堆栈日志： 

[此处粘贴完整的异常堆栈日志]

 # 输出要求（严格按以下结构输出，不要遗漏） 1. 异常核心信息提取： - 异常类型：[如IndexError/NullPointerException] - 错误消息：[复制堆栈中的错误描述] - 错误位置：文件路径：[如user_manage.py]，行号：[如25] - 关键调用链路（仅保留业务代码，过滤框架底层代码）：[按“文件行号→函数名”格式列出，如：main.py第18行→get_user_info → user_manage.py第25行→return users[index]] 2. 可能的错误根因（列出2-3个最可能的原因，结合代码逻辑推测）： - 根因1：[如“传入的index=5超过列表users的长度（假设users仅包含3个元素），导致索引越界”] - 根因2：[如“函数get_user_info未对输入的index进行合法性校验（如未判断index是否小于len(users)）”] - 根因3：[如“列表users初始化时数据缺失，实际长度为0，导致任何index都越界”] 3. 排查步骤（step-by-step，从简单到复杂）： Step 1：[如“打开错误位置文件user_manage.py第25行，查看users列表的定义与赋值逻辑，确认users的实际长度”] Step 2：[如“检查调用get_user_info函数的位置（main.py第18行），确认传入的index值是否合理（如是否大于等于0且小于len(users)）”] Step 3：[如“在get_user_info函数中添加日志，打印调用时的index值和users列表内容，重新运行程序验证根因”] 4. 调试代码片段（可选，若适用）： [生成可直接插入的调试代码，如打印变量、添加校验逻辑] 

基础模板实战案例（Python 索引越界错误）

开发者输入（堆栈日志）

Traceback (most recent call last): File "user_manage.py", line 25, in get_user_info return users[index] File "main.py", line 18, in <module> user = get_user_info(5) IndexError: list index out of range 

模型输出（基于基础模板）

1. 异常核心信息提取：
   • 异常类型：IndexError（列表索引越界）
   • 错误消息：list index out of range
   • 错误位置：文件路径：user_manage.py，行号：25
   • 关键调用链路（仅保留业务代码）：main.py第18行→get_user_info → user_manage.py第25行→return users[index]
2. 可能的错误根因：
   • 根因1：传入的index=5超过列表users的实际长度（推测users列表长度≤4，如仅存储了4个用户数据），导致索引越界。
   • 根因2：函数get_user_info未对输入参数index进行合法性校验（如未判断index是否在[0, len(users)-1]范围内），直接使用参数访问列表。
   • 根因3：列表users在初始化时未成功加载数据（如从数据库查询用户失败，返回空列表），此时任何index都会触发越界错误。
3. 排查步骤：
   Step 1：打开user_manage.py文件，定位第25行，查看users列表的定义位置（如是否在函数内初始化，或从其他函数/文件传入），打印len(users)确认列表实际长度。
   Step 2：跳转至main.py第18行，检查调用get_user_info时传入的index=5是否合理（如是否应为动态获取的用户ID，而非固定值5；是否存在计算错误，如index=user_id-1但user_id=6时导致index=5）。
   Step 3：在get_user_info函数开头添加调试日志：print(f"当前index: {index}, users列表长度: {len(users)}, users内容: {users}")，重新运行程序，观察日志输出确认根因。
4. 调试代码片段：

# 优化后的get_user_info函数（添加参数校验与调试日志）defget_user_info(index):# 调试日志：打印关键变量print(f"调试信息 - index: {index}, users长度: {len(users)}, users: {users}")# 参数合法性校验ifnotisinstance(index,int):raise TypeError("index必须为整数")if index <0or index >=len(users):raise ValueError(f"index超出有效范围，当前users列表长度为{len(users)}，有效index范围：0~{len(users)-1}")return users[index]

3.2 进阶模板：面向资深开发者，覆盖跨服务/复杂场景

进阶模板适用于微服务、分布式应用、多语言混合架构的复杂错误场景，核心是“补充上下文信息”——要求开发者提供更多维度的输入（如调用链路、配置参数、输入数据），引导模型进行“关联分析”，定位跨服务或非代码层面的根因（如配置错误、数据库连接失败）。

进阶模板结构（微服务版）

# 角色与任务 你是一位微服务架构调试专家，擅长分析跨服务调用中的错误根因，熟悉[指定技术栈，如Spring Cloud/Dubbo + MySQL + Redis]。请基于我提供的“异常堆栈+调用链路+上下文信息”，完成深度错误定位。 # 输入信息（请开发者按以下格式补充，缺一不可） 1. 异常堆栈日志（当前服务的完整堆栈）： 

[此处粘贴当前服务的异常堆栈]

 2. 跨服务调用链路（如APM工具记录的链路，格式：调用方服务→被调用方服务→接口名）： [如：用户服务（user-service）→ 订单服务（order-service）→ /api/order/create（POST）] 3. 上下文补充： - 输入数据（当前接口的请求参数，脱敏处理）：[如：{"userId": "12345", "productId": "P001", "quantity": -1}] - 相关配置（如数据库连接、Redis地址、第三方接口地址）：[如：MySQL地址：jdbc:mysql://192.168.1.100:3306/order_db；Redis地址：192.168.1.101:6379] - 异常发生时间与频率：[如：2024-05-20 14:30首次发生，之后每10分钟触发一次；仅当quantity为负数时触发] # 输出要求（严格按以下结构，需包含跨服务排查点） 1. 异常核心信息提取（含跨服务关联）： - 异常类型与错误消息：[如SQLIntegrityConstraintViolationException: Column 'quantity' cannot be null] - 错误位置（当前服务）：文件：[如OrderController.java]，行号：[如48]，方法：[如createOrder] - 跨服务调用链路梳理：[按“服务→接口→参数传递”格式，标注可能的异常传递点，如：user-service→order-service:/api/order/create（传递参数quantity=-1）→ order-service调用MySQL插入订单（quantity字段不允许负数）] 2. 多维度根因分析（分“代码层”“配置层”“依赖层”）： - 代码层根因：[如“order-service的OrderController未对quantity参数进行合法性校验（允许负数），导致插入MySQL时触发字段约束错误”] - 配置层根因（可选）：[如“MySQL的order表中quantity字段未设置默认值，且未显式标注NOT NULL，但业务逻辑要求该字段必须为正数，配置与业务不匹配”] - 依赖层根因（可选）：[如“user-service在调用order-service时，未过滤非法的quantity值（如用户前端传入负数时未拦截），导致错误向下传递”] 3. 跨服务排查步骤（按“当前服务→上游服务→依赖服务”顺序）： Step 1：排查当前服务（order-service）： - 打开OrderController.java第48行，查看createOrder方法是否对quantity参数进行校验（如是否判断quantity > 0）； - 检查OrderMapper.xml中插入订单的SQL语句，确认quantity字段是否有约束（如CHECK(quantity > 0)）。 Step 2：排查上游服务（user-service）： - 找到user-service调用order-service的代码（如OrderFeignClient.java），查看是否有参数校验逻辑（如是否过滤quantity ≤ 0的请求）； - 查看user-service的前端接口（如/user/createOrder）是否有前端校验（如禁止输入负数），是否存在前端校验被绕过的情况（如直接调用API）。 Step 3：排查依赖服务（MySQL）： - 登录MySQL的order_db数据库，执行`DESC order;`查看quantity字段的约束（如是否为INT NOT NULL，是否有CHECK约束）； - 执行`SELECT * FROM order WHERE quantity < 0;`确认是否存在历史非法数据，判断是否为偶发还是批量问题。 4. 解决方案与优化建议（含跨服务协同）： - 短期修复：[如“在order-service的createOrder方法中添加quantity参数校验（quantity > 0），抛出IllegalArgumentException并返回400错误；在user-service的Feign调用前补充相同校验，双重拦截非法参数”] - 长期优化：[如“使用Spring Cloud Gateway统一拦截所有请求，添加通用参数校验规则；在MySQL表中为quantity字段添加CHECK(quantity > 0)约束，从数据库层兜底；接入APM工具（如SkyWalking），设置异常告警触发阈值”] 

进阶模板实战案例（微服务订单创建错误）

开发者输入（完整上下文）

1. 异常堆栈日志（order-service）：

org.springframework.dao.DataIntegrityViolationException: ### Error updating database. Cause: com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Check constraint 'order_quantity_check' violated for table 'order' ### The error may exist in com/order/mapper/OrderMapper.xml ### The error may involve com.order.mapper.OrderMapper.insert-Inline ### The error occurred while setting parameters ### SQL: INSERT INTO order (user_id, product_id, quantity, create_time) VALUES (?, ?, ?, ?) ### Cause: com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Check constraint 'order_quantity_check' violated for table 'order' ; SQL []; Data truncation: Check constraint 'order_quantity_check' violated for table 'order'; nested exception is com.mysql.cj.jdbc.exceptions.MysqlDataTruncation: Data truncation: Check constraint 'order_quantity_check' violated for table 'order' at org.springframework.jdbc.support.SQLStateSQLExceptionTranslator.doTranslate(SQLStateSQLExceptionTranslator.java:104) at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:70) at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:79) at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:91) at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:441) at jdk.proxy2/jdk.proxy2.$Proxy85.insert(Unknown Source) at org.mybatis.spring.SqlSessionTemplate.insert(SqlSessionTemplate.java:272) at com.order.service.impl.OrderServiceImpl.createOrder(OrderServiceImpl.java:65) # 错误位置 at com.order.controller.OrderController.createOrder(OrderController.java:48) at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ...（框架代码省略） 

2. 跨服务调用链路：
   user-service（用户服务）→ order-service（订单服务）→ /api/order/create（POST接口）
3. 上下文补充：
   • 输入数据：{"userId": "12345", "productId": "P001", "quantity": -2, "createTime": "2024-05-20 14:30:00"}
   • 相关配置：MySQL地址：jdbc:mysql://192.168.1.100:3306/order_db；order表的quantity字段约束：quantity INT NOT NULL CHECK (quantity > 0)
   • 异常发生时间与频率：2024-05-20 14:30首次发生，截至15:00共触发5次，均为quantity为负数的请求。

模型输出（基于进阶模板）

1. 异常核心信息提取（含跨服务关联）：
   • 异常类型与错误消息：DataIntegrityViolationException（数据完整性约束异常），根因：MySQL的order_quantity_check约束被违反（quantity字段需>0）
   • 错误位置（当前服务）：文件：OrderServiceImpl.java，行号：65，方法：createOrder；Controller层位置：OrderController.java第48行，方法：createOrder
   • 跨服务调用链路梳理：user-service→order-service:/api/order/create（传递参数quantity=-2）→ order-service的OrderServiceImpl第65行调用MyBatis插入订单→ MySQL执行INSERT语句时触发CHECK约束（quantity>0），抛出异常。
2. 多维度根因分析：
   • 代码层根因：order-service的OrderController和OrderServiceImpl均未对quantity参数进行合法性校验（未判断quantity>0），直接将负数参数传递至MyBatis，触发MySQL约束错误；同时，user-service在调用order-service前也未拦截quantity=-2的非法参数，导致错误向下传递。
   • 配置层根因：MySQL的order表虽设置了CHECK(quantity>0)约束，但该约束属于“兜底措施”，未在应用层（order-service/user-service）提前拦截，导致异常需通过数据库层抛出，增加排查链路长度。
   • 依赖层根因：前端页面（用户服务的下单页面）可能未添加quantity的输入校验（如禁止输入负数），或校验被绕过（如用户通过Postman直接调用user-service的接口传入负数），导致非法参数进入服务链路。
3. 跨服务排查步骤：
   Step 1：排查当前服务（order-service）：Step 2：排查上游服务（user-service）：Step 3：排查依赖服务（MySQL与前端）：
   • 打开OrderController.java第48行，查看createOrder方法的参数接收逻辑，确认是否使用JSR-380校验注解（如@Min(1)）对quantity进行校验；
   • 打开OrderServiceImpl.java第65行，查看是否在调用mapper.insert前对quantity进行业务校验（如if (quantity <= 0) throw new IllegalArgumentException("订单数量必须为正数")）；
   • 检查OrderMapper.xml中的INSERT语句，确认是否有额外的参数过滤逻辑（如quantity = IF(#{quantity} > 0, #{quantity}, NULL)，但NULL会触发NOT NULL约束，非最优解）。
• 找到user-service中调用order-service的Feign客户端（如OrderFeignClient.java），查看调用createOrder接口时是否有参数校验（如Assert.isTrue(quantity > 0, "订单数量不能为负数")）；
• 查看user-service的前端接口（如/UserOrderController的createOrder方法），确认是否添加@Min(1)注解或手动校验，判断是否存在前端校验缺失导致非法参数传入。
• 登录192.168.1.100的order_db数据库，执行SELECT * FROM order WHERE quantity <= 0;，确认是否存在历史非法数据（若有，需排查之前的校验漏洞）；
• 访问user-service的下单页面，尝试输入quantity=-2并提交，观察是否有前端提示（如“数量必须大于0”），判断是否存在前端校验被绕过的情况（如直接调用API）。
4. 解决方案与优化建议（含跨服务协同）：
   • 短期修复：
     1. 在order-service的OrderController.createOrder方法的quantity参数上添加@Min(value = 1, message = "订单数量必须为正数（≥1）")，并在全局异常处理器中捕获MethodArgumentNotValidException，返回400错误与提示信息；
     2. 在user-service的Feign调用前添加参数校验：if (quantity <= 0) throw new BadRequestException("订单数量不能为负数");，双重拦截非法参数；
     3. 临时屏蔽quantity=-2的请求：在Spring Cloud Gateway中添加路由过滤器，拦截所有quantity≤0的/create请求，直接返回400错误。
   • 长期优化：
     1. 统一校验标准：在微服务架构中引入“公共校验组件”，定义quantity、userId等通用参数的校验规则（如quantity≥1、userId不为空），所有服务依赖该组件，避免重复开发；
     2. 数据库层强化：为order表的quantity字段添加更明确的错误提示，如CHECK (quantity > 0) COMMENT '订单数量必须为正数'，便于快速识别约束含义；
     3. 监控与告警：在APM工具（如SkyWalking）中为DataIntegrityViolationException设置告警规则（如10分钟内触发3次则发送邮件/钉钉告警），并关联调用链路信息，便于快速定位；
     4. 前端与后端双重校验：要求所有输入参数在前端（如Vue/React）和后端（服务层）均进行校验，前端拦截常规错误，后端兜底异常，形成“双重保障”。

四、不同语言/场景的错误定位 Prompt 适配技巧

不同编程语言的异常堆栈格式、错误类型命名存在差异（如 Java 的 NullPointerException vs Python 的 AttributeError），不同场景（如前端 JS 错误、后端数据库错误）的排查重点也不同。需根据具体场景调整 Prompt 的“语言特性”与“输出侧重点”。

4.1 多语言适配：Java、Python、JavaScript 差异调整

1. Java 场景：突出“异常链”与“框架层级过滤”

Java 堆栈常包含大量框架代码（如 Spring、MyBatis），Prompt 需明确“过滤框架无关调用”，同时关注“异常链”（如 DataIntegrityViolationException 的根因是 MysqlDataTruncation）。

Java 专属 Prompt 片段：

# 语言特性适配 - 请识别异常链中的“根异常”（如被cause包裹的MysqlDataTruncation、NullPointerException），优先基于根异常分析根因； - 过滤框架底层代码调用（如org.springframework.*、org.mybatis.*、java.base.*包下的调用），仅保留业务代码（如com.xxx.service、com.xxx.controller包下的调用）； - 若涉及Spring Boot框架，请额外分析是否为“配置错误”（如application.yml中的数据库连接地址错误）或“依赖冲突”（如jar包版本不兼容）。 

2. Python 场景：关注“模块导入”与“第三方库错误”

Python 错误常涉及模块导入（如 ModuleNotFoundError）、第三方库使用（如 pandas 的 KeyError），Prompt 需引导模型分析“依赖安装”与“库版本兼容性”。

Python 专属 Prompt 片段：

# 语言特性适配 - 若异常类型为ModuleNotFoundError，请优先分析“是否已安装该模块”（如`pip list | grep 模块名`）及“Python环境是否正确”（如虚拟环境未激活）； - 若涉及第三方库（如pandas、requests），请推测是否为“库版本不兼容”（如pandas 1.0与2.0的API差异），并建议查看库的官方文档确认用法； - 若为装饰器、生成器相关错误（如StopIteration），请结合Python语法特性分析（如生成器未正确yield值）。 

3. JavaScript（前端/Node.js）场景：区分“语法错误”与“运行时错误”

JS 错误分为语法错误（如 SyntaxError: Unexpected token '{'）和运行时错误（如 TypeError: Cannot read property 'name' of undefined），前端场景还需关注“DOM操作”“异步请求”（如 Axios 404 错误）。

JavaScript 专属 Prompt 片段：

# 语言特性适配（区分前端/Node.js） - 若为前端场景（含浏览器控制台错误）： 1. 若涉及DOM操作（如document.getElementById），请分析“DOM元素是否存在”（如元素未加载完成就执行操作，需添加DOMContentLoaded事件监听）； 2. 若为异步请求错误（如AxiosError），请分析“请求URL是否正确”“跨域配置是否缺失”“响应状态码含义”（如401未授权、404接口不存在）。 - 若为Node.js场景： 1. 若涉及文件操作（如fs.readFile），请分析“文件路径是否正确”（相对路径vs绝对路径）、“文件权限是否足够”； 2. 若为EventEmitter相关错误（如“error”事件未监听），请建议添加`emitter.on('error', (err) => console.error(err))`避免程序崩溃。 

4.2 特殊场景适配：数据库错误、分布式链路错误

1. 数据库错误场景（MySQL、PostgreSQL、MongoDB）

数据库错误的根因常涉及“SQL语法”“字段约束”“连接配置”，Prompt 需引导模型分析 SQL 语句与数据库配置的匹配性。

数据库错误专属 Prompt 片段：

# 数据库场景适配 - 若为SQL语法错误（如SQLSyntaxError）： 1. 请检查SQL语句的“关键字拼写”（如SELECT写成SELEC）、“括号/引号配对”（如字符串未闭合）、“表名/字段名大小写”（如MySQL默认不区分大小写，但Linux环境下可能区分）； 2. 若使用ORM框架（如MyBatis、Hibernate），请分析XML映射文件中的SQL是否存在语法错误（如#{参数名}是否正确，是否多写逗号）。 - 若为连接错误（如SQLTransientConnectionException）： 1. 请检查数据库“连接地址、端口、用户名、密码”是否正确（如application.yml中的配置）； 2. 分析“数据库是否启动”“网络是否可达”（如ping数据库IP、telnet端口）、“连接池配置是否合理”（如最大连接数不足导致连接超时）。 - 若为NoSQL数据库（如MongoDB）： 1. 若为Bson语法错误，请检查查询条件是否符合MongoDB语法（如使用$gt而非>）； 2. 若为集合不存在错误，请分析“是否未创建集合”或“集合名拼写错误”。 

2. 分布式链路错误场景（微服务、分布式事务）

分布式错误的根因常涉及“服务间通信”“分布式事务一致性”“服务可用性”，Prompt 需引导模型分析“上游服务状态”“网络链路”“事务回滚情况”。

分布式链路专属 Prompt 片段：

# 分布式场景适配 - 请结合APM调用链路（如SkyWalking、Zipkin）分析以下点： 1. 上游服务是否正常返回（如user-service是否返回200，是否存在超时）； 2. 服务间通信协议是否存在问题（如Dubbo调用的序列化方式不兼容，HTTP调用的Content-Type不匹配）； 3. 分布式事务是否触发回滚（如Seata事务未提交，导致数据不一致）。 - 若涉及消息队列（如RabbitMQ、Kafka）： 1. 分析“消息是否成功发送”“消费者是否正常消费”（如队列堆积、消费者抛出异常导致消息重发）； 2. 检查“消息序列化/反序列化是否正确”（如JSON格式错误，导致消费者无法解析）。 

五、错误定位 Prompt 的输出优化：避免泛泛而谈，提升实用性

即使使用上述模板，模型仍可能输出“泛泛而谈”的建议（如“检查代码是否有错误”）。需通过“约束输出细节”“添加负面清单”“示例引导”三个技巧，提升输出的精准性与可操作性。

5.1 技巧1：约束输出细节——要求“具体到文件/行号/代码片段”

在 Prompt 的输出要求中，明确“禁止模糊表述”，强制模型结合输入的堆栈信息，输出具体的文件路径、行号，甚至推测可能的代码片段。

反例（泛泛而谈）：
“请检查quantity参数的校验逻辑，确保其为正数。”

正例（具体细节）：
“请检查order-service的OrderController.java第48行，确认是否在createOrder方法的quantity参数上添加了@Min(1)注解；若未添加，请补充该注解，并在全局异常处理器中捕获MethodArgumentNotValidException，返回‘订单数量必须为正数’的提示。”

Prompt 约束语句：

# 输出细节约束 - 所有排查步骤必须“具体到文件路径、行号、方法名”，禁止使用“某个文件”“某段代码”等模糊表述； - 根因分析需结合输入的“异常堆栈+上下文信息”，禁止输出与当前场景无关的通用建议（如“检查代码是否有语法错误”）； - 调试代码片段需可直接运行（如包含完整的函数定义、导入语句），并标注“需替换的变量”（如`[请替换为实际的数据库连接池配置]`）。 

5.2 技巧2：添加负面清单——明确“禁止输出的内容”

提前在 Prompt 中列出“禁止输出的内容”，避免模型输出无用信息（如基础语法讲解、与场景无关的知识点），聚焦错误定位本身。

负面清单示例：

# 输出负面清单（禁止包含以下内容） 1. 禁止讲解基础编程语言语法（如“Java的try-catch语句用法”“Python的列表定义方式”）； 2. 禁止输出与当前错误无关的通用开发规范（如“代码缩进应使用4个空格”“变量命名应使用驼峰式”）； 3. 禁止使用过于学术化的表述（如“该异常属于运行时异常，继承自RuntimeException”），需用通俗语言解释，并直接关联解决方案； 4. 禁止推荐未经验证的工具或框架（如“建议使用XXX调试工具”，除非该工具与当前错误定位直接相关且为行业通用工具）。 

5.3 技巧3：示例引导——给模型“正确输出的参考案例”

若模型对复杂场景的输出仍不理想，可在 Prompt 中添加“正确输出示例”，让模型参考示例的结构与细节程度，生成更符合预期的内容。

示例引导片段（Java 空指针错误）：

# 正确输出示例参考（仅为格式与细节参考，非当前问题答案） 假设输入堆栈为： java.lang.NullPointerException: Cannot invoke "com.user.entity.User.getName()" because "user" is null at com.user.service.UserServiceImpl.getUserName(UserServiceImpl.java:32) at com.user.controller.UserController.getUserName(UserController.java:20) 正确输出参考（根因分析部分）： - 根因1：UserServiceImpl.java第32行调用user.getName()时，user对象为null，推测“获取user对象的逻辑存在漏洞”（如从数据库查询user时返回null，未处理该情况）； - 根因2：UserController.java第20行调用UserServiceImpl.getUserName时，传入的user对象为null（如前端未传递user_id，导致查询不到user）。 请参考上述示例的细节程度，分析当前问题的根因，确保每个根因都关联具体的文件、行号与代码逻辑。 

六、章节总结与课后练习

6.1 章节总结

本章系统讲解了错误定位 Prompt 的设计与应用，核心要点可归纳为：

1. 基础认知：异常堆栈是错误定位的核心证据，需提取“异常类型、错误位置、调用链路”三大信息；
2. 模板设计：基础模板面向单体应用/新手，侧重“结构化输出”；进阶模板面向微服务/资深开发者，侧重“跨服务关联分析”；
3. 场景适配：根据语言（Java/Python/JS）、场景（数据库/分布式）调整 Prompt 的“语言特性”与“排查重点”；
4. 输出优化：通过“约束细节、负面清单、示例引导”，避免模型输出泛泛而谈，提升建议的可操作性。

掌握错误定位 Prompt 的设计技巧，能让开发者将大语言模型转化为“专属调试助手”，大幅减少排查错误的时间，尤其在面对陌生项目或复杂架构时，效果更为显著。

6.2 课后练习

练习1：Python 字典键不存在错误（基础场景）

任务：基于以下异常堆栈，使用“基础模板”设计 Prompt，并生成模型输出（需包含异常提取、根因分析、排查步骤、调试代码）。

输入堆栈日志：

Traceback (most recent call last): File "product_manage.py", line 38, in get_product_price return product["price"] # 尝试获取字典中不存在的"price"键 File "main.py", line 22, in <module> price = get_product_price({"id": "P001", "name": "手机"}) KeyError: 'price' 

练习2：Java 微服务数据库连接错误（进阶场景）

任务：基于以下上下文信息，使用“进阶模板”设计 Prompt，并生成模型输出（需包含跨服务排查、多维度根因分析）。

输入信息：

1. 异常堆栈日志（product-service）：

org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to obtain JDBC Connection; nested exception is com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server. at org.springframework.jdbc.datasource.DataSourceUtils.getConnection(DataSourceUtils.java:83) at org.mybatis.spring.transaction.SpringManagedTransaction.openConnection(SpringManagedTransaction.java:80) at org.mybatis.spring.transaction.SpringManagedTransaction.getConnection(SpringManagedTransaction.java:67) at org.apache.ibatis.executor.BaseExecutor.getConnection(BaseExecutor.java:337) at org.apache.ibatis.executor.SimpleExecutor.prepareStatement(SimpleExecutor.java:86) at org.apache.ibatis.executor.SimpleExecutor.doQuery(SimpleExecutor.java:62) at org.apache.ibatis.executor.BaseExecutor.queryFromDatabase(BaseExecutor.java:325) at org.apache.ibatis.executor.BaseExecutor.query(BaseExecutor.java:156) at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:151) at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:145) at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:78) at jdk.proxy2/jdk.proxy2.$Proxy92.getProductById(Unknown Source) at com.product.service.impl.ProductServiceImpl.getProductById(ProductServiceImpl.java:42) # 错误位置 ...（框架代码省略） 

2. 跨服务调用链路：
   api-gateway（网关）→ product-service（商品服务）→ /api/product/getById（GET接口，参数id=P001）
3. 上下文补充：
   • 输入数据：请求URL：http://localhost:8080/api/product/getById?id=P001，请求方法：GET；
   • 相关配置：product-service 的 application.yml 中数据库配置：spring.datasource.url: jdbc:mysql://192.168.1.200:3306/product_db?useSSL=false，用户名：root，密码：123456；
   • 异常发生情况：所有调用product-service的请求均触发该错误，重启服务后仍无法解决；其他服务（如user-service）可正常连接MySQL（地址：192.168.1.100:3306）。

练习3：前端 JavaScript 异步请求错误（场景适配）

任务：基于以下前端错误信息，设计“JavaScript 前端专属 Prompt”，并生成模型输出（需包含DOM操作、异步请求排查）。

输入信息：

1. 浏览器控制台错误：

Uncaught (in promise) AxiosError: Request failed with status code 404 at settle (axios.min.js:1:14975) at XMLHttpRequest.onloadend (axios.min.js:1:13512) at getProductDetail (productDetail.js:15) # 错误位置 at HTMLButtonElement.onclick (productDetail.html:28) # 触发事件 

2. 上下文补充：
   • 操作步骤：用户在productDetail.html页面点击“查看商品详情”按钮（id=“getDetailBtn”），触发onclick事件调用getProductDetail函数；
   • 后端服务信息：后端商品服务的正确接口地址为/api/product/getDetail（非/api/product/detail），服务已启动，端口8080。

相关代码（productDetail.js第15行）：

asyncfunctiongetProductDetail(){const productId = document.getElementById("productId").value;const response =await axios.get("/api/product/detail",{params:{id: productId }});// 第15行 console.log(response.data);}

6.3 练习参考答案（思路点拨）

练习1 参考答案思路

1. 异常核心信息提取：
   • 异常类型：KeyError（字典键不存在）；
   • 错误位置：product_manage.py第38行，get_product_price函数；
   • 关键调用链路：main.py第22行→get_product_price（传入字典{“id”:“P001”,“name”:“手机”}）→ product_manage.py第38行→return product[“price”]。
2. 根因分析：
   • 根因1：传入的product字典仅包含"id"和"name"键，无"price"键，导致获取时抛出KeyError；
   • 根因2：get_product_price函数未判断"price"键是否存在（如未使用product.get("price")或"price" in product），直接访问键。
3. 排查步骤：
   • Step 1：检查main.py第22行，确认传入的product字典是否应包含"price"键（如是否遗漏从数据库查询price字段）；
   • Step 2：在product_manage.py第38行前添加键存在性判断，如if "price" not in product: raise KeyError("product字典缺少'price'键")。
4. 调试代码：

defget_product_price(product):# 检查键是否存在ifnotisinstance(product,dict):raise TypeError("product必须为字典类型")if"price"notin product:raise KeyError(f"product字典缺少'price'键，当前键列表：{list(product.keys())}")return product["price"]# 调用时补充price键 price = get_product_price({"id":"P001","name":"手机","price":3999})

练习2 参考答案思路

1. 异常核心信息提取：
   • 异常类型：CannotGetJdbcConnectionException（无法获取JDBC连接），根因：CommunicationsException（通信链路失败）；
   • 跨服务链路：api-gateway→product-service:/api/product/getById→ product-service连接MySQL（192.168.1.200:3306）失败。
2. 多维度根因分析：
   • 代码层根因：无（连接错误非代码逻辑问题）；
   • 配置层根因：product-service的MySQL地址配置错误（192.168.1.200:3306），而其他服务（如user-service）使用192.168.1.100:3306可正常连接，推测地址写错；
   • 依赖层根因：192.168.1.200的MySQL未启动、端口被占用，或网络防火墙禁止product-service访问该地址。
3. 排查步骤：
   • Step 1：检查product-service的application.yml，确认MySQL地址是否应为192.168.1.100:3306（与user-service一致）；
   • Step 2：在product-service服务器上执行ping 192.168.1.200和telnet 192.168.1.200 3306，确认网络是否可达；
   • Step 3：登录192.168.1.200服务器，执行systemctl status mysqld确认MySQL是否启动，若未启动则执行systemctl start mysqld。
4. 解决方案：
   • 修改application.yml的MySQL地址为jdbc:mysql://192.168.1.100:3306/product_db?useSSL=false，重启product-service；
   • 在生产环境中，将数据库地址配置为配置中心（如Nacos）的动态配置，避免硬编码错误。

练习3 参考答案思路

1. 异常核心信息提取：
   • 异常类型：AxiosError（404 Not Found）；
   • 错误位置：productDetail.js第15行，getProductDetail函数（Axios GET请求）；
   • 触发链路：productDetail.html第28行（按钮onclick事件）→ getProductDetail → 调用Axios请求/api/product/detail→ 404错误。
2. 根因分析：
   • 根因1：Axios请求的接口地址错误（/api/product/detail），后端正确地址为/api/product/getDetail，导致404；
   • 根因2：未处理Axios请求的Promise异常（如未使用try-catch或.catch()），导致“Uncaught (in promise)”错误；
   • 根因3：未验证productId是否为空（如用户未输入id直接点击按钮，可能导致后端接口参数缺失，但当前错误核心是地址错误）。
3. 排查步骤：
   • Step 1：打开浏览器“网络”面板（F12），查看GET请求的“请求URL”，确认是否为http://localhost:8080/api/product/detail?id=xxx，对比后端正确地址；
   • Step 2：修改productDetail.js第15行的接口地址为/api/product/getDetail，重新测试；
   • Step 3：在getProductDetail函数中添加try-catch捕获Promise异常，避免控制台报错。
4. 调试代码：

asyncfunctiongetProductDetail(){try{const productId = document.getElementById("productId").value;// 1. 验证productId是否为空if(!productId){alert("请输入商品ID");return;}// 2. 修正接口地址为正确的/getDetailconst response =await axios.get("/api/product/getDetail",{params:{id: productId }}); console.log(response.data);}catch(error){// 3. 捕获并处理异常if(error.response){// 服务器返回错误（如404、500）alert(`请求错误：${error.response.status} - ${error.response.statusText}`);}elseif(error.request){// 无响应（如网络错误）alert("网络错误，无法连接服务器");}else{// 请求发送前的错误（如参数错误）alert(`请求失败：${error.message}`);}}}// 优化：使用addEventListener绑定事件，而非HTML onclick（更符合前端最佳实践） document.getElementById("getDetailBtn").addEventListener("click", getProductDetail);

联系博主

    xcLeigh 博主，全栈领域优质创作者，博客专家，目前，活跃在ZEEKLOG、微信公众号、小红书、知乎、掘金、快手、思否、微博、51CTO、B站、腾讯云开发者社区、阿里云开发者社区等平台，全网拥有几十万的粉丝，全网统一IP为 xcLeigh。希望通过我的分享，让大家能在喜悦的情况下收获到有用的知识。主要分享编程、开发工具、算法、技术学习心得等内容。很多读者评价他的文章简洁易懂，尤其对于一些复杂的技术话题，他能通过通俗的语言来解释，帮助初学者更好地理解。博客通常也会涉及一些实践经验，项目分享以及解决实际开发中遇到的问题。如果你是开发领域的初学者，或者在学习一些新的编程语言或框架，关注他的文章对你有很大帮助。

    亲爱的朋友，无论前路如何漫长与崎岖，都请怀揣梦想的火种，因为在生活的广袤星空中，总有一颗属于你的璀璨星辰在熠熠生辉，静候你抵达。

     愿你在这纷繁世间，能时常收获微小而确定的幸福，如春日微风轻拂面庞，所有的疲惫与烦恼都能被温柔以待，内心永远充盈着安宁与慰藉。

    至此，文章已至尾声，而您的故事仍在续写，不知您对文中所叙有何独特见解？期待您在心中与我对话，开启思想的新交流。

     💞 关注博主 🌀 带你实现畅游前后端！

     🏰 大屏可视化 🌀 带你体验酷炫大屏！

     💯 神秘个人简介 🌀 带你体验不一样得介绍！

     🥇 从零到一学习Python 🌀 带你玩转Python技术流！

     🏆 前沿应用深度测评 🌀 前沿AI产品热门应用在线等你来发掘！

     💦 注：本文撰写于ZEEKLOG平台,作者：xcLeigh（所有权归作者所有） ，https://xcleigh.blog.ZEEKLOG.net/，如果相关下载没有跳转，请查看这个地址，相关链接没有跳转，皆是抄袭本文，转载请备注本文原地址。

     📣 亲，码字不易，动动小手，欢迎 点赞 ➕ 收藏，如 🈶 问题请留言（或者关注下方公众号，看见后第一时间回复，还有海量编程资料等你来领！），博主看见后一定及时给您答复 💌💌💌