现象

  • ✅ 自定义 POJO（如 QueryDTO）作为 Controller 方法参数，不加任何注解 也能正常工作。

  • ❌ 接口 List（或 Map）作为参数，不加注解 就会报错

原因分析

参数类型Spring 默认处理方式实例化过程结果
自定义类（有默认构造器）@ModelAttribute调用无参构造器创建对象 → 用请求参数匹配 setter 赋值✅ 成功
List 接口（无构造器）@ModelAttribute尝试通过反射获取构造器实例化 → 接口没有构造器❌ 抛异常

解决方案

明确告诉 Spring 如何将请求数据转换成 List：

// 1. 接收 Query String 多值：?ids=1,2,3 或 ?ids=1&ids=2
public String method(@RequestParam List<String> ids) { ... }

// 2. 接收 JSON 数组：[ "a", "b" ]
public String method(@RequestBody List<String> items) { ... }

// 3. 改用包装类（提供具体实现）
public class Wrapper { private List<String> ids = new ArrayList<>(); /*getter/setter*/ }
public String method(Wrapper wrapper) { ... }   // 仍可无注解

核心结论

Spring 只能自动实例化“有构造器的具体类”；接口或抽象类型必须用 @RequestParam、@RequestBody 等注解显式指定数据绑定方式。

# spring # mvc # java
Logo
AI编程社区

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

码道 · 寻艺——从零构建“非遗交互式对话平台“的完整实践

avatar AI编程社区

码道：用 Python + FastAPI 快速构建一个学生信息管理接口：从零到 Swagger 在线文档

在日常开发和教学中，我们经常需要一套简单、可控、能快速上手的后端接口来演示"前后端分离"、练习 Restful API 设计，或者作为前端联调的 Mock 服务。传统做法往往是搭一套完整的 Web 工程：配置数据库、编写 DAO、引入 ORM、做请求分发……一套流程下来，光环境搭建就要花去不少时间，对于想快速验证想法、或者刚入门 API 开发的同学来说，显得过于沉重。

avatar AI编程社区

码道：从零构建学生信息管理系统 API：FastAPI 内存版 CRUD 项目全解析

FastAPI 的强大，很大程度上来自 Pydantic 的校验能力。我们写下类型声明，FastAPI 在运行时自动把它变成边界检查器。name：字符串，长度限制 1 到 50；age：整数，限制在 6 到 120 之间（ge大于等于、le小于等于）；gender：字符串，用正则限定只能是"男"“女”“其他”；email：邮箱格式字符串；grade与major：可选字段，代表班级和专业方向。

avatar AI编程社区