错误定位 Prompt：利用 AI 快速定位异常堆栈

错误定位 Prompt：利用 AI 快速定位异常堆栈 | 极客日志

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 # 异常类型：列表索引越界

痛点类型	具体表现	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 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) # 错误位置
...（框架代码省略）

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);

错误定位 Prompt：利用 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 参考答案思路

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

更多推荐文章

相关免费在线工具