执行摘要
本PR修复了vLLM Responses API中JSON Schema序列化的bug，通过添加by_alias=True参数确保Pydantic模型字段别名正确使用，避免了内部字段schema_泄漏，恢复了非Harmony tool-calling功能。变更影响前端Responses模块，涉及API路由、协议和测试更新，是一个有意义的改进，值得关注序列化设计决策。
功能与动机
为什么做：Responses API在使用JSON Schema时，非流式响应和流式响应会错误地输出内部字段schema_而非公开字段schema，导致非Harmony tool-calling（当tool_choice="required"时）中断。Issue #38245报告了此bug，PR #38262尝试修复但未完全解决流式响应问题。
实现拆解
按模块拆解改动：
- API路由模块 (
vllm/entrypoints/openai/responses/api_router.py)：在_convert_stream_to_sse_events、create_responses、retrieve_responses和cancel_responses函数中，为model_dump_json和model_dump添加by_alias=True，确保事件流和JSON响应序列化使用别名。
- 协议模块 (
vllm/entrypoints/openai/responses/protocol.py)：修改serialize_message函数，用model_dump(mode="json", by_alias=True)替代model_dump_json(by_alias=True)，返回Python字典而非JSON字符串，修复消息序列化回归。
- 服务模块 (
vllm/entrypoints/openai/responses/serving.py)：在生成ResponseCreatedEvent时添加by_alias=True，确保初始响应正确序列化。
- 测试模块 (
tests/entrypoints/openai/responses/test_serving_responses.py)：新增test_response_created_event_uses_public_json_schema_alias测试，验证别名序列化；更新Harmony相关测试使用Message.from_dict处理消息格式。
评论区精华
提炼review讨论：
- 在Issue评论中，noobHappylife和chaunceyjiang发现了Harmony消息序列化不一致问题：非流式测试假设嵌套
author格式，而流式测试使用Message.from_dict期望扁平格式。chaunceyjiang确认：> "使用嵌套author结构会导致数据丢失。" 最终结论是更新测试以使用Message.from_dict，确保消息格式正确。
- Review中，gemini-code-assist[bot]总结变更：> "更新序列化以使用字段别名，确保如
schema字段正确命名。" chaunceyjiang批准PR。
风险与影响
具体风险：
- 序列化逻辑变更：API响应格式可能因其他未处理别名字段而受影响，但变更局限于Responses模块，风险较低。
- 回归风险：
serialize_message函数修改返回类型，可能影响依赖组件，但添加了单元测试test_serialize_message_pydantic_model_returns_dict覆盖。
- 兼容性影响：修复后，API响应将严格遵循OpenAI规范，提升工具调用兼容性，对用户透明。
影响范围：
- 用户：修复tool-calling中断，提升使用JSON Schema和
tool_choice="required"场景的体验。
- 系统：确保Responses API输出一致性，减少字段泄漏，增强可靠性。
- 团队：测试更新强调了消息格式处理，为类似序列化问题提供参考。
关联脉络
与历史PR的关系：
- PR #38262（"[frontend] dump openai responses type by alias"）直接关联，它尝试修复同一Issue但未解决流式响应问题，本PR是后续完善。
- 结合近期PR分析，如PR #39114（"[Bugfix] Fix Gemma4 streaming tool call corruption"）也涉及tool-calling修复，显示团队在前端和工具调用模块持续优化兼容性和稳定性。本PR是这一趋势的一部分，专注于API响应序列化细节，以确保与OpenAI标准对齐。
参与讨论