openapi-typescript 项目中空数组查询参数的问题解析

问题背景

在使用 openapi-typescript 项目中的 openapi-fetch 客户端时，开发者发现了一个关于查询参数处理的异常行为。当向 API 端点发送包含多个空数组作为查询参数的请求时，生成的 URL 会出现不符合预期的格式。

问题现象

具体表现为：当开发者使用 openapi-fetch 客户端向 /posts 端点发送请求，并传递四个空数组作为查询参数时：

client.GET('/posts', {
    params: {
        query: {
            first_array: [],
            second_array: [],
            third_array: [],
            fourth_array: [],
        },
    },
});

预期结果是这些空数组应该像 undefined 或 null 一样被忽略，不应对查询字符串产生影响。然而实际生成的请求 URL 却是 http://localhost:3001/posts?&&&，出现了三个孤立的 & 符号。

技术分析

这个问题本质上属于 URL 查询字符串构建逻辑的缺陷。在 HTTP 规范中，查询参数通常以 key=value 的形式出现，多个参数间用 & 符号分隔。当值为空数组时，合理的处理方式应该是完全忽略该参数，而不是保留分隔符。

从实现角度看，问题可能出在以下几个方面：

1. 参数序列化逻辑没有正确处理空数组的情况
2. 参数过滤阶段未能有效剔除空数组
3. URL 构建过程中对分隔符的处理不够严谨

影响范围

这个 bug 主要影响以下场景：

• 使用 openapi-fetch 客户端发送包含数组类型查询参数的请求
• 当这些数组为空时
• 特别是当有多个空数组参数时

虽然不影响功能实现，但会导致生成的 URL 不够规范，可能在某些严格的服务器端引起解析问题，也不利于调试和日志分析。

解决方案建议

针对这个问题，可以考虑以下几种修复方案：

1. 在参数序列化前过滤掉所有空数组
2. 修改 URL 构建逻辑，避免生成孤立的分隔符
3. 增加对空数组的特殊处理，将其视为 undefined

最合理的方案可能是第一种，即在参数处理阶段就过滤掉空数组，保持与 undefined/null 一致的行为。

总结

openapi-typescript 项目中的这个查询参数处理问题虽然不影响核心功能，但反映了边界条件处理的重要性。作为 TypeScript 生态中重要的 OpenAPI 工具链组件，这类细节问题的修复有助于提升开发体验和代码质量。该问题已被标记为适合新手贡献的良好起点，期待社区能尽快提供修复方案。