[P1/高] openai-format tool 消息 content 可能被赋为 undefined，导致 API 400 #26

New Issue

2026-07-21T21:55:53+08:00

thzxx commented

2026-07-21 21:55:53 +08:00

问题类型

缺陷 / 高 / LLM 适配器

文件位置

electron/harness/adapters/shared/openai-format.ts

问题描述

构建 OpenAI 兼容消息时：

const message = {
  role: 'tool',
  content: toolResult.content ?? undefined, // 错误
  tool_call_id: toolCall.id,
};

当 toolResult.content 为 null 或空时，赋为 undefined，序列化后字段消失。
OpenAI / DeepSeek / Agnes API 严格要求 tool 消息必须有 content 字段，缺失会返回 400：

Invalid value for 'messages[].content': field is required

影响

工具失败后下次请求必然 400
整个会话卡死

建议修复

const message = {
  role: 'tool',
  content: toolResult.content ?? '', // 空字符串而非 undefined
  tool_call_id: toolCall.id,
};

或保留错误信息：

content: toolResult.content ?? toolResult.error ?? '',

project_memory.md 已要求：

Assistant messages with tool_calls must set content to null (not empty string) to avoid API 400 errors

但 tool 角色消息与 assistant 不同，必须有非空 content。

## 问题类型缺陷 / 高 / LLM 适配器 ## 文件位置 `electron/harness/adapters/shared/openai-format.ts` ## 问题描述构建 OpenAI 兼容消息时： ```ts const message = { role: 'tool', content: toolResult.content ?? undefined, // 错误 tool_call_id: toolCall.id, }; ``` 当 `toolResult.content` 为 null 或空时，赋为 `undefined`，序列化后字段消失。 OpenAI / DeepSeek / Agnes API 严格要求 tool 消息必须有 `content` 字段，缺失会返回 400： ``` Invalid value for 'messages[].content': field is required ``` ## 影响 - 工具失败后下次请求必然 400 - 整个会话卡死 ## 建议修复 ```ts const message = { role: 'tool', content: toolResult.content ?? '', // 空字符串而非 undefined tool_call_id: toolCall.id, }; ``` 或保留错误信息： ```ts content: toolResult.content ?? toolResult.error ?? '', ``` project_memory.md 已要求： > Assistant messages with tool_calls must set content to null (not empty string) to avoid API 400 errors 但 tool 角色消息与 assistant 不同，必须有非空 content。

thzxx added the LLM?????? labels 2026-07-21 21:55:53 +08:00

thzxx commented

2026-07-22 09:43:01 +08:00

修复说明

文件: electron/harness/adapters/shared/openai-format.ts

修复: tool 消息 content 赋值后增加 if (msg.content === undefined) msg.content = '' 检查。JSON.stringify(undefined) 返回 undefined（非字符串），会导致 content 字段在序列化后消失，API 返回 400。

验证: tsc --noEmit 类型检查通过。

## 修复说明 **文件**: `electron/harness/adapters/shared/openai-format.ts` **修复**: tool 消息 content 赋值后增加 `if (msg.content === undefined) msg.content = ''` 检查。`JSON.stringify(undefined)` 返回 `undefined`（非字符串），会导致 content 字段在序列化后消失，API 返回 400。 **验证**: `tsc --noEmit` 类型检查通过。

thzxx closed this issue

2026-07-22 09:43:02 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MetonaTeam/metona-ai-desktop#26