Gemini 工具调用返回参数错误
Gemini function calling 的参数结构问题：schema 不合法、缺必填、类型不匹配。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
geminifunction-calling
30 秒结论
工具 schema 写得不合法，或者模型返回的参数不符合 schema。
报错原文对照
Invalid argument: tools[0].function_declarations[0].parameters原因排序
| 概率 | 原因 |
|---|---|
| 50% | schema 用了不支持的 JSON Schema 关键字 |
| 30% | 必填字段缺 |
| 20% | 模型返回格式偏差 |
修法
先在自己这边查
- schema 只用 type/properties/required/enum
- 给必填字段加 default
- 对返回参数做校验和重试
再往服务方查
- 中转站可能不支持工具调用
责任判定表
| 现象 | 责任方 |
|---|---|
| 官方好、中转站报 | 中转站能力 |
| 都报 | schema |
| 偶发 | 模型输出 |
什么时候该换
工具 schema 越简单越稳。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证