mybatis xml返回对象类型和接口定义类型不一致

发布时间:2026/9/30 3:49:03
mybatis xml返回对象类型和接口定义类型不一致 问题背景最近在开发中发现MyBatis XML 映射文件中定义的返回值类型与 Mapper 接口中声明的泛型类型不一致导致实际查询返回的对象类型与预期不符。代码示例1. XML 映射文件 (xxxxMapper.xml)select idselectPlanList parameterTypePlan resultMapPlanListVo select * from table_name /selectresultMap typecom.demo.vo.PlanListVo idPlanListVo !-- 字段映射配置 -- id propertyid columnid/ result propertyname columnname/ result propertycreateTime columncreate_time/ /resultMap2. Mapper 接口 (xxxxMapper.java)ListPlan selectPlanList(Plan plan);3. Service 实现类 (xxxxServiceImpl.java)Override public ListPlan selectPlanList(Plan plan) { return planMapper.selectPlanList(plan); }问题分析在上述代码中XML 映射文件的resultMap指定返回类型为com.demo.vo.PlanListVo而 Mapper 接口中声明的返回类型为ListPlan。当调用planMapper.selectPlanList(plan)时MyBatis 会按照 XML 中配置的PlanListVo类型来创建对象并封装结果集。但由于 Java 泛型在运行时会被擦除接口中声明的ListPlan类型约束在运行时无法生效因此实际返回的是ListPlanListVo类型的列表而不是ListPlan。解决方案保持类型一致将 XML 中的resultMap类型改为Plan或者将 Mapper 接口的返回类型改为ListPlanListVo。使用类型别名在 MyBatis 配置文件中配置类型别名避免硬编码全限定类名。运行时类型检查在 Service 层对返回结果进行类型转换或验证确保类型安全。总结MyBatis 执行查询时实际返回的对象类型由 XML 映射文件中的resultType或resultMap决定而不是由 Mapper 接口的泛型声明决定。开发时需确保两者类型一致避免因泛型擦除导致的类型不匹配问题。

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询