ASP.NET Core 6 Web API：复杂JSON转查询字符串绑定失败

常见原因及修复方案 #

1. 查询字符串格式不符合后端解析规则 #

GET请求传递数组时，不能直接将sortBy: ["id", "desc"]转成sortBy=["id","desc"]，多数后端框架（如Spring Boot、Express）需要用带方括号的参数名或重复参数名来识别数组：

• 错误格式：?page=1&page_size=10&sortBy=["id","desc"]
• 正确格式1（PHP/Express常用）：?page=1&page_size=10&sortBy[]=id&sortBy[]=desc
• 正确格式2（部分框架支持）：?page=1&page_size=10&sortBy=id&sortBy=desc

2. 后端参数绑定配置问题 #

• Spring Boot后端：确保用@RequestParam List<String> sortBy接收，而非@RequestParam String sortBy；若用自定义对象接收，需保证对象内sortBy为集合类型，且框架开启数组/集合自动解析。
• Express后端：直接通过req.query.sortBy获取，重复参数会自动转为数组，无需额外配置。

3. 前端参数序列化工具问题 #

多数前端工具（如axios）默认不会自动将数组转为符合后端要求的格式，需手动配置序列化规则：

axios.get('/api/data', {
  params: {
    page: 1,
    page_size: 10,
    sortBy: ['id', 'desc']
  },
  paramsSerializer: params => {
    // 用URLSearchParams自动处理为重复参数格式
    return new URLSearchParams(params).toString()
    // 或用qs库指定数组格式：qs.stringify(params, { arrayFormat: 'brackets' })
  }
})

4. 后端参数类型不匹配 #

若后端将sortBy定义为字符串类型，前端传递数组格式会导致解析为null。需检查后端参数类型与前端结构一致：

• Java示例：

public ResponseEntity<?> getData(
    @RequestParam Integer page,
    @RequestParam Integer page_size,
    @RequestParam List<String> sortBy
) {
    // 业务逻辑
}

调试技巧 #

• 直接在浏览器地址栏输入正确格式的查询字符串，测试后端是否能获取sortBy，排除前端编码问题。
• 用浏览器开发者工具查看请求的Query String Parameters，确认实际发送的参数格式。
• 后端打印原始查询字符串日志，对比与前端发送内容是否一致。

内容的提问来源于stack exchange，提问作者Lan Lin