kknongchang_2506/app/Console/Commands

错误复现命令 (ReproduceErrorCommand)

概述

debug:reproduce-error 命令用于通过 sys_request_logs 表中的请求记录来复现错误请求，帮助开发者进行调试和问题排查。

功能特性

• 支持通过 id、request_unid 或 run_unid 查找请求记录
• 自动提取请求记录中的 protobuf_json 和 token 信息
• 参考 ProtoJsonRequestTest 的实现方式发起 HTTP 请求
• 使用环境变量 UNITTEST_URL 作为目标地址
• 详细的日志记录和错误处理
• 支持自定义请求超时时间

命令语法

php artisan debug:reproduce-error <identifier> [options]

参数

• identifier: 请求标识符，可以是以下任意一种：
  • 数据库记录的 id（数字）
  • request_unid（字符串）
  • run_unid（字符串）

选项

• --type=TYPE: 指定标识符类型，可选值：

  • auto（默认）：自动检测类型
  • id：按数据库 ID 查找
  • request_unid：按请求唯一标识符查找
  • run_unid：按运行唯一标识符查找

• --timeout=SECONDS: 设置请求超时时间（秒），默认为 30 秒

使用示例

1. 通过数据库 ID 复现请求

php artisan debug:reproduce-error 68973973

2. 通过 request_unid 复现请求

php artisan debug:reproduce-error 6840202392627

3. 指定标识符类型

php artisan debug:reproduce-error 68973973 --type=id
php artisan debug:reproduce-error 6840202392627 --type=request_unid

4. 设置自定义超时时间

php artisan debug:reproduce-error 68973973 --timeout=60

输出示例

开始查找请求记录...
标识符: 68973973
类型: auto
找到请求记录:
  ID: 68973973
  Request UNID: 6840202392627
  Run UNID: 
  路径: gameapi
  方法: POST
  创建时间: 2025-06-04 18:29:55
提取到 token: f4b3c51a58...
目标地址: http://kku_laravel.local.gd/
开始发起请求...
请求完成，响应结果:
状态码: 200
响应头:
  Server: nginx/1.27.4
  Date: Wed, 04 Jun 2025 12:59:52 GMT
  Content-Type: application/json
  Transfer-Encoding: chunked
  Connection: keep-alive
  X-Powered-By: PHP/8.3.21
  Cache-Control: no-cache, private
  Vary: Origin
响应内容:
{"runUnid":"68404347a6a07","runMs":"6","code":"OK","callpath":"Shop-Query","lastData":[],"shopQuery":{"lastTimes":"1748943300"}}

环境配置

确保在 .env 文件中配置了正确的 UNITTEST_URL：

UNITTEST_URL=http://kku_laravel.local.gd/

错误处理

命令会处理以下错误情况：

1. 未找到请求记录：当指定的标识符在数据库中不存在时
2. 缺少 protobuf_json 数据：当请求记录中没有必要的请求数据时
3. 网络请求失败：当向目标服务器发起请求失败时
4. JSON 解析错误：当解析 headers 或响应数据失败时

日志记录

命令会在 Laravel 日志中记录详细的执行信息：

• 请求开始和完成的时间戳
• 请求和响应的数据长度
• 错误信息和堆栈跟踪

技术实现

核心组件

1. RequestLog 模型：用于查询 sys_request_logs 表
2. GuzzleHttp 客户端：用于发起 HTTP 请求
3. JSON 解析：提取 headers 中的 token 信息
4. 错误处理：完善的异常捕获和用户友好的错误提示

请求流程

1. 根据标识符和类型查找请求记录
2. 验证请求记录的完整性
3. 从 headers 中提取 token
4. 初始化 HTTP 客户端
5. 发起 POST 请求到 /gameapi 端点
6. 解析和展示响应结果

注意事项

• 命令会禁用 SSL 验证以支持本地开发环境
• Token 在输出时会被截断显示以保护敏感信息
• 请求超时时间可以根据实际需要调整
• 确保目标服务器能够正常处理复现的请求

相关文件

• 命令文件：app/Console/Commands/ReproduceErrorCommand.php
• 模型文件：UCore/Model/RequestLog.php
• 测试参考：tests/Unit/ProtoJsonRequestTest.php