编程语言Node.jsAIjava

利用 AI 提示词快速定位程序异常堆栈

错误定位 Prompt 旨在解决开发者面对冗长堆栈信息时的效率痛点。通过设计结构化指令，引导大语言模型自动解析异常类型、调用链路及错误位置，推测根因并提供具体排查步骤。内容涵盖基础模板与微服务进阶模板，适配 Java、Python、JavaScript 等多语言场景，并结合数据库、分布式链路等特殊环境优化输出细节，帮助开发者借助 AI 高效完成程序调试与问题修复。

SqlMaster发布于 2026/4/8更新于 2026/5/2315 浏览

错误定位 Prompt，快速定位异常堆栈

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

一、章节引言：为什么错误定位需要专门的 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（描述错误具体原因）；
：从顶层调用（第 18 行）到错误发生点（第 25 行）的完整代码路径；

main.py

user_manage.py

痛点类型	具体表现	Prompt 解决思路
信息过载	复杂系统的堆栈日志长达数百行，包含大量无关调用（如框架底层代码），难以筛选关键信息	指令中明确要求'过滤框架无关调用，仅保留业务代码层级''标注堆栈中的核心错误行'
经验依赖	新手难以识别异常类型与代码逻辑的关联（如'SQLSyntaxError'可能是字段名拼写错误，也可能是语法格式问题）	Prompt 中嵌入'异常类型映射表'，引导模型根据异常类型输出常见根因（如：SQLSyntaxError → 1. 字段名错误；2. 关键字拼写错误；3. 括号不匹配）
场景缺失	堆栈仅包含代码调用，缺乏上下文（如输入数据、配置参数、数据库状态），导致模型无法判断根因	指令中要求开发者补充'输入数据示例''相关配置片段'，并引导模型结合上下文分析（如：'根据输入的 user_id=0，推测可能触发数据库主键约束错误'）
跨服务复杂	微服务架构中，错误可能源于上游服务的参数传递（如网关转发的参数格式错误），但堆栈仅显示当前服务的调用	Prompt 设计'跨服务调用链路补充'模块，要求模型输出'可能的上游依赖排查点'（如：'检查网关服务是否正确转换了请求参数格式，是否存在字段缺失'）

# 角色与任务
你是一位资深软件开发调试助手，擅长 [指定语言，如 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. 调试代码片段（可选，若适用）：
   [生成可直接插入的调试代码，如打印变量、添加校验逻辑]

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

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

# 角色与任务
你是一位微服务架构调试专家，擅长分析跨服务调用中的错误根因，熟悉 [指定技术栈，如 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），设置异常告警触发阈值']

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)...（框架代码省略）

异常核心信息提取（含跨服务关联）：
- 异常类型与错误消息：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），抛出异常。
多维度根因分析：
- 代码层根因：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 的接口传入负数），导致非法参数进入服务链路。
跨服务排查步骤： Step 1：排查当前服务（order-service）： - 打开 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 约束，非最优解）。 Step 2：排查上游服务（user-service）： - 找到 user-service 中调用 order-service 的 Feign 客户端（如 OrderFeignClient.java），查看调用 createOrder 接口时是否有参数校验（如 Assert.isTrue(quantity > 0, "订单数量不能为负数")）； - 查看 user-service 的前端接口（如/UserOrderController 的 createOrder 方法），确认是否添加@Min(1) 注解或手动校验，判断是否存在前端校验缺失导致非法参数传入。 Step 3：排查依赖服务（MySQL 与前端）： - 登录 192.168.1.100 的 order_db 数据库，执行 SELECT * FROM order WHERE quantity <= 0;，确认是否存在历史非法数据（若有，需排查之前的校验漏洞）； - 访问 user-service 的下单页面，尝试输入 quantity=-2 并提交，观察是否有前端提示（如'数量必须大于 0'），判断是否存在前端校验被绕过的情况（如直接调用 API）。
解决方案与优化建议（含跨服务协同）：
- 短期修复：
  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）和后端（服务层）均进行校验，前端拦截常规错误，后端兜底异常，形成'双重保障'。

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

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

# 语言特性适配（区分前端/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))` 避免程序崩溃。

# 数据库场景适配
- 若为 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. 若为集合不存在错误，请分析'是否未创建集合'或'集合名拼写错误'。

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

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

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

# 正确输出示例参考（仅为格式与细节参考，非当前问题答案）
假设输入堆栈为：
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）。

请参考上述示例的细节程度，分析当前问题的根因，确保每个根因都关联具体的文件、行号与代码逻辑。

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'

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 com.product.service.impl.ProductServiceImpl.getProductById(ProductServiceImpl.java:42) # 错误位置
...（框架代码省略）

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) # 触发事件

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

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

async function getProductDetail(){
    try{
        const productId = document.getElementById("productId").value;
        // 1. 验证 productId 是否为空
        if(!productId){
            alert("请输入商品 ID");
            return;
        }
        // 2. 修正接口地址为正确的/getDetail
        const 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}`);
        }else if(error.request){
            // 无响应（如网络错误）
            alert("网络错误，无法连接服务器");
        }else{
            // 请求发送前的错误（如参数错误）
            alert(`请求失败：${error.message}`);
        }
    }
}
// 优化：使用 addEventListener 绑定事件，而非 HTML onclick（更符合前端最佳实践）
document.getElementById("getDetailBtn").addEventListener("click", getProductDetail);

利用 AI 提示词快速定位程序异常堆栈

错误定位 Prompt，快速定位异常堆栈

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

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

2.1 什么是异常堆栈？

利用 AI 提示词快速定位程序异常堆栈

错误定位 Prompt，快速定位异常堆栈

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

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

2.1 什么是异常堆栈？

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

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

2.3 错误定位 Prompt 的核心目标

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

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

基础模板结构（通用版）

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

开发者输入（堆栈日志）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

六、章节总结与课后练习

6.1 章节总结

6.2 课后练习

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

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

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

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

练习 1 参考答案思路

练习 2 参考答案思路

练习 3 参考答案思路

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具