API 返回成功，参数却没生效？从客户端漏传到网关删参的排查教程

接口返回 HTTP 200，但结构化格式没有按要求输出，或者换了中转站后同一项设置似乎不再起作用，先不要凭回答风格判断模型被换了。需要核对的是：字段有没有从客户端发出、经过网关后是否保留，以及最终端点是否支持这个字段及其具体用法。

本文聚焦参数在调用链中的传递与验收，不重复讲采样参数如何调优。LiteLLM 和 OpenRouter 仅作为有官方文档的机制示例，不代表所有中转站采用相同行为。文档核对日期为 2026-10-19；下面的离线示例经过本地模拟验证，没有调用真实付费 API，也不构成对某家服务商的实测结论。

1. 把“没生效”拆成四层证据

界面中的设置值、SDK 收到的对象和实际发出的 HTTP 正文可能并不一致。先记录客户端版本、接口路径、精确模型 ID、账户分组，以及是否使用流式和自动回退，再按顺序找字段在哪一层变化。

只在自己有权限的测试环境查看记录。向客服提供请求编号与必要的脱敏字段，不发送完整鉴权头或私人提示词。如果看不到第三方网关的上游出口，就把这一层记为“未知”，请对方依据请求编号确认实际转发字段。不能用客户端日志填补看不到的证据。

尤其要区分四种变化：字段完全缺失；数字变成字符串；有明确协议依据的字段映射；字段保留但对应功能不支持。映射不必然是错误，原样透传也不必然是正确。

2. 先检查漏传和删参，再调整数值

从一条已知可以完成基础任务的最小请求开始，每次只添加一个待检查字段，固定其他条件。查看最终序列化后的正文，不只看调用 SDK 前打印的变量。

客户端常见问题包括：配置被另一个默认项覆盖、字段放错嵌套位置、SDK 不接受某个扩展字段，或者构建请求时把 0 和 false 当成“没有填写”。空值 null、省略字段和有效的零值也不是同一回事；接口是否允许 null 要查其文档，不能统一替换。

网关也可能主动删参。LiteLLM 官方文档说明：默认情况下，向不支持某参数的模型传参会抛出异常；设置 drop_params=True 后，会改为丢弃不支持的参数。另有 additional_drop_params 可指定删除字段。[1] 因此，关闭报错不代表补上了能力，有时只是把约束拿掉了。

同一文档中的 allowed_openai_params 用于放行并透传指定字段。这个名称属于 LiteLLM 配置；它不能让不支持某功能的上游凭空支持该功能。只有确认字段与目标接口契约相符后，才考虑调整放行配置。不要把这些开关直接复制到其他产品。

如果你依赖的是必须满足的输出格式、工具限制或其他业务约束，优先明确失败并保留诊断信息。只有业务明确允许降级时，才移除某字段，并把“约束已降低”记录为不同运行模式，不能仍标记为原任务完全成功。

3. 在本地比较两个阶段的字段

下面的 Node.js 示例不联网。保存为 compare-fields.mjs，运行 node compare-fields.mjs。两份 JSON 都是假数据，模拟网关把一个值改写并删除一个字段的情况；它不会自动抓取你的真实请求。

import { isDeepStrictEqual } from 'node:util';

const fields = ['temperature', 'stream', 'response_format'];

export function compareFields(beforeText, afterText) {
  const parse = (text) => {
    if (typeof text !== 'string' || text.length > 100000) {
      throw new TypeError('Expected a JSON string of at most 100000 characters');
    }
    const value = JSON.parse(text);
    if (value === null || Array.isArray(value) || typeof value !== 'object') {
      throw new TypeError('Expected a JSON object');
    }
    return value;
  };
  const before = parse(beforeText);
  const after = parse(afterText);
  return fields.map((field) => {
    const left = Object.hasOwn(before, field);
    const right = Object.hasOwn(after, field);
    const state = !left && !right ? 'absent'
      : left && !right ? 'removed'
      : !left && right ? 'added'
      : isDeepStrictEqual(before[field], after[field]) ? 'same' : 'changed';
    return { field, state };
  });
}

const before = JSON.stringify({
  temperature: 0, stream: false,
  response_format: { type: 'json_object' }
});
const after = JSON.stringify({ temperature: 0.7, stream: false });
console.log(compareFields(before, after));

预期结果分别是：temperature 为 changed，stream 为 same，response_format 为 removed。示例只输出固定白名单中的字段名与状态，不打印字段值、密钥或正文。接入你自己的诊断流程时，仍应使用无敏感内容的样本，避免把完整生产请求写入文件或日志。

这个比较器能保留 0、false 与 null 的区别，能识别数字和字符串不一致，比较嵌套对象时不依赖对象键的排列顺序。它只检查列出的三个顶层字段，不校验参数合法性，也不判断协议转换是否正确。需要比较字段映射时，先根据目标协议建立对应关系；不能把两个不同协议的正文直接逐字段判错。

本地模拟覆盖了字段增加、删除、改值、类型变化、零值与布尔值、空值与缺失、嵌套对象键顺序，以及无效 JSON、非对象和过长输入。通过这些检查只证明比较器在这些样例上符合预期，不证明某网关真实转发正确。

4. 核对“支持字段”到底支持到哪一级

填写一张能力记录卡：接口及版本、精确模型 ID、服务商端点或分组、字段名称、取值范围、允许组合、流式限制、文档链接和核对日期。模型介绍页说“支持工具”或“支持图片”，不等于你选中的接口、渠道和参数组合全部可用。

例如，格式参数支持一个基础模式，不代表支持全部 Schema 关键字；某个字段可以单独使用，不代表能和其他模式任意组合。接口接受字段后，仍可能因内容限制、输出截断或其他原因得到不合格结果，需要看具体错误和结束状态。

OpenRouter 当前路由文档提供 provider.require_parameters，默认值为 false。设为 true 会排除不支持请求参数的服务商；默认情况下，不支持的参数仍可能被忽略。[2] 文档还说明，部分字段存在支持偏好：有支持端点时优先限制到支持者，但没有支持者时，默认偏好仍可能允许忽略字段。因此“通常会选支持端点”不能代替强制要求。

这项路由筛选不等于保证每次输出正确，也不是所有网关的通用参数。若筛选后没有可用路径，应调查能力和路由限制，不能为了消除错误就无声放宽必须满足的约束。自动换端点或换模型也会干扰判断，诊断时应把每次实际路径及回退情况记录下来；范围控制可参照API 模型回退检查。

5. 用对照结果定位，不用回答风格猜测

下面是建议执行的验收方案，不是已经对服务商完成的测试。使用非敏感固定输入、有限次数和已确认的预算；不重试明显的参数错误，也不让诊断调用执行真实写入或付款工具。

对格式约束，检查能否解析、字段类型和必填项是否符合业务规则；对流式开关，检查实际响应类型及事件结构；对工具限制，只使用不会执行外部动作的模拟工具观察结果。采样参数影响的是生成分布，两次回答风格的变化不足以证明参数传递或生效。

最后保存三份互相对应的记录：预期约束、可观察到的请求字段、实际验收结果。如果只有成功样例而没有字段证据，应写“该样例通过”，不要写“参数已证实被严格执行”。向服务商反馈时附时间、请求编号、接口与版本、字段差异和预期行为；可沿用最小复现与脱敏工单模板。

参考资料：[1] LiteLLM：Drop Unsupported Params；[2] OpenRouter：Provider Routing。两者仅支持文中对应产品的机制说明，不用于推定其他中转站的行为。