“非法参数”错误源于请求体字段类型与openapi契约不符，需校验json结构、用ajv工具本地验证、开启调试日志比对入参、最小化请求体逐字段排查，并确保content-type与utf-8编码一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy调用技能时收到“非法参数”错误提示，通常是由于请求体中某个字段的类型与接口契约定义不符，例如将字符串传入要求整型的字段、布尔值缺失、或嵌套对象结构不匹配。以下是针对该问题的多种校验与修复方法：
一、检查请求体JSON结构是否符合OpenAPI Schema定义
WorkBuddy技能接口通常依据OpenAPI 3.0规范定义请求体结构，字段类型、必填性、枚举值及嵌套层级均被严格约束。需比对实际发送的JSON与文档中requestBody.schema部分的一致性。
1、打开对应技能的OpenAPI文档页面，定位到POST路径下的requestBody节，展开schema树形结构。
2、确认每个字段的type（如string、integer、boolean、object）、format（如email、int32）、required数组所列字段是否全部提供。
3、检查字段值是否满足format约束：例如phone字段标注format: phone，则必须为符合E.164格式的字符串，不能含空格或横线。
4、若字段类型为object，验证其内部属性名、类型及嵌套深度是否与schema完全一致，特别注意大小写敏感和下划线/驼峰命名差异。
二、使用JSON Schema校验工具本地验证请求体
在发送请求前，可通过离线工具对原始JSON进行静态类型校验，提前暴露字段类型不匹配问题，避免依赖服务端返回模糊错误。
1、将OpenAPI文档中的schema片段提取为独立JSON Schema文件（保留$ref内联或使用swagger-cli resolve处理引用）。
2、安装ajv CLI工具：执行npm install -g ajv-cli。
3、运行校验命令：ajv validate -s schema.json -d request_body.json。
4、若校验失败，输出将明确指出哪一路径的字段类型错误，例如“/user/age must be integer”，此时应修正该字段值而非忽略报错。
三、启用WorkBuddy调试模式并捕获原始入参日志
WorkBuddy平台支持开启技能调用链路的详细日志，可直接查看网关解析后的最终请求体，用于确认序列化过程是否引入类型转换异常。
1、进入WorkBuddy控制台，找到对应Bot，在“技能配置”页启用“调试日志”开关。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、重新触发技能调用，等待10–30秒后在“调用记录”中查找最新条目，点击展开“入参快照”面板。
3、比对快照中显示的字段类型与原始请求体，重点观察number类型是否被误转为string（如"123"而非123）、null值是否被强制替换为空字符串。
4、若发现类型被篡改，检查客户端SDK版本或序列化逻辑，禁用自动类型转换中间件或显式指定Content-Type为application/json;charset=UTF-8。
四、逐字段手工构造最小化请求体进行排障
当错误信息未指明具体字段时，可采用控制变量法，从仅含1个必填字段的最简JSON开始逐步扩展，定位首个引发非法参数的字段。
1、查阅接口文档，提取required数组中的首个字段名及其示例值。
2、构造仅包含该字段的JSON，如{"query": "天气"}，发起调用。
3、若成功，追加第二个required字段；若失败，检查该字段的值是否符合type与format要求，尤其注意时间字段是否误用Date对象而非ISO 8601字符串。
4、重复此过程直至复现错误，此时最后添加的字段即为非法参数来源。
五、检查HTTP头部Content-Type与实际载荷编码一致性
即使JSON内容正确，若请求头声明的Content-Type与实际数据格式冲突，WorkBuddy网关可能拒绝解析或执行错误类型推断。
1、确认请求头中存在Content-Type: application/json，且无额外字符（如空格、分号后缀）。
2、检查请求体是否为UTF-8无BOM编码的纯文本JSON，禁止混入不可见Unicode控制字符（如U+200B零宽空格）。
3、若使用curl测试，确保使用-d参数而非--data-binary，并避免shell变量展开导致引号丢失。
4、在Postman中关闭“Automatically persist cookies”等可能干扰header的选项，手动设置Header并勾选“Content-Type”不被自动覆盖。
