error rule 新增错误规则 all messages must have non-empty content except for the optional final assistant message

[ding113]

Errors 完整内容示例：

[{"error":"Error: 400 {\"type\":\"error\",\"error\":{\"type\":\"invalid_request_error\",\"message\":\"messages.0: all messages must have non-empty content except for the optional final assistant message\"}}\n    at eQ.generate (file:///home/mman/.npm-global/lib/node_modules/@anthropic-ai/claude-code/cli.js:1180:6428)\n    at k$.makeStatusError (file:///home/mman/.npm-global/lib/node_modules/@anthropic-ai/claude-code/cli.js:1197:2101)\n    at k$.makeRequest (file:///home/mman/.npm-global/lib/node_modules/@anthropic-ai/claude-code/cli.js:1197:5315)\n    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)","timestamp":"2025-07-17T04:25:01.491Z"}]

[ding113]

@claude fix it

[ding113]

I've created a fix for this issue.

Pull Request: #433

Changes made:

• Added a new default error rule to handle the "all messages must have non-empty content except for the optional final assistant message" validation error
• The rule uses contains match type with pattern all messages must have non-empty content
• Categorized as validation_error with priority 89 (non-retryable)
• Override response provides a user-friendly message: "消息内容不能为空，请确保所有消息都有有效内容（最后一条 assistant 消息除外）"

Please review and let me know if you need any adjustments.

---

Response from Claude AI

[github-actions]

Thank you for reporting this issue and providing the complete error message.

Analysis:

This is a request to add a new default error rule for the Claude API validation error: "all messages must have non-empty content except for the optional final assistant message". This error occurs when the client sends a message array where one or more messages have empty content.

Error Rules System:

The error rules system is defined in:

• src/repository/error-rules.ts (lines 292-637) - Contains the DEFAULT_ERROR_RULES array
• src/lib/error-rule-detector.ts - Detection engine that matches errors against rules
• src/drizzle/schema.ts (lines 352-379) - Database schema for error_rules table

Implementation Details:

To add this error rule, a new entry should be added to the DEFAULT_ERROR_RULES array in src/repository/error-rules.ts. Based on similar validation error rules (e.g., lines 423-457), the rule would use:

• matchType: "contains" - Simple substring matching is sufficient for this error message
• category: "validation_error" - This is a request validation error, non-retryable
• priority: 89 - Similar to other validation errors

Existing Similar Rules:

Several similar validation error rules already exist:

• "tool_use ids must be unique" (line 425-439)
• "Tool names must be unique" (line 441-457)
• "ValidationException" (line 343-357)

These use the same pattern of contains match type with validation_error category.

---

Automated response from Claude AI

[github-actions]

谢谢反馈这个错误示例。

相关实现（错误规则是怎么起作用的）

• 匹配文本优先取上游响应体 ProxyError.upstreamError.body：src/app/v1/_lib/proxy/errors.ts:469

function extractErrorContentForDetection(error: Error): string {
  // 优先使用整个响应体进行规则匹配
  if (error instanceof ProxyError && error.upstreamError?.body) {
    return error.upstreamError.body;
  }
  return error.message;
}

• 只要命中任意启用规则，就会被归类为 NON_RETRYABLE_CLIENT_ERROR：src/app/v1/_lib/proxy/errors.ts:768，并在转发器里停止重试/不切换供应商：src/app/v1/_lib/proxy/forwarder.ts:447
• 默认规则清单在 DEFAULT_ERROR_RULES：src/repository/error-rules.ts:292，启动时会同步到 DB 并 reload 缓存：src/instrumentation.ts:27

为何需要新增这条规则

• 你给的示例里包含 invalid_request_error 和消息 all messages must have non-empty content ...。
• 目前默认规则里有一条较泛的 invalid_request 正则 非法请求|illegal request|invalid request：src/repository/error-rules.ts:590，但它不会匹配 invalid_request_error（下划线）这一段，除非上游 body 里同时包含带空格的 invalid request。

建议的规则形态（供维护者实现或你在后台自定义）

• matchType: "contains"（contains 会做小写比较，等价于大小写不敏感：src/lib/error-rule-detector.ts:196）
• pattern: all messages must have non-empty content except for the optional final assistant message（或更窄一些加上 messages.0:）
• category: invalid_request 或 parameter_error（创建入口目前限制了类别集合：src/actions/error-rules.ts:60）

需要补充的信息

• 代理侧实际记录到 ProxyError.upstreamError.body 的完整响应体（脱敏即可），用来确认最终应该匹配的字符串/是否需要更宽的 pattern：src/app/v1/_lib/proxy/errors.ts:469

---

Automated response from Codex AI