MyBatis 通用查询如何避免 SELECT *？MetaLite 如何按需返回字段

先澄清一个事实：MyBatis 并不会强迫开发者写 Select *。 不过，它最大的优势之一正是 SQL 完全可控。 话说回来，

真正的痛点是通用查询。说起来，条件、排序、分页都希望复用，返回字段又因场景不同而变化。团队要么复制多条 SQL，要么让公共方法查询整行数据。导致数据库 IO、网络传输、对象转换和 JVM 占用明显提高。

MetaLite ORM 将字段选择提高为 #query#  的标准组成部分。其实，

一、findOne 和 findList 为什么都需要字段投影

• User 列表只需要 id 、昵称 和状态。不需要头像原图或个人资料；
• 二、Query 同时支持 include 与 exclude

  \*仅返回明确字段\* java Query query = Query.query) .includeField(UserEntity::getId。UserEntity::getNickname,UserEntity::getStatus);List users = userDao.findListByQuery;\*排除少数大字段\* java Query query = Query.query) .excludeField(UserEntity::getAvatar,UserEntity::getProfile);UserElement user = userDao.findOneByQuery;注：

  • \*.includeField\*.excludeField\*均提供字符串集合还有方法引用重载版本。- 推荐使用方法引用，可在实体改名后在编译阶段捕获影响范围。.

  三、JD娱乐 最终如何生成 SELECT 列

  • ① 若某列出现在 \*.excludeFields 集合中。即使同时被 \*.includeFields 指定，该列也会被完全忽略。​​​​​​​​​​ ​​​ ​​​ ​​​ ​​​。​​​​​​​​​​ 请注意此处采用“粗体”文本以突出关键性，以免读者遗漏该关键规则。​ ⑨ 在实际执行之前会对包括与排除集合进行交集与差集计算，从而得到最终待选列列表。⑩ 若未指定任何包含或排除，则默认拉取所有列。但通过显式配置即可覆盖这一默认行为。其实， 另外为了保证 SQL 合法性框架在拼接完成后会自动删除末尾多余逗号。并校验至少保留一个有效列，否则抛出异常提示“无效的 Query 配置”，以防出现空结果导致运行时异常。  请务必在调用前做配置校验，并将此逻辑作为框架安全检查的一部分。从(hint来看，若你想查看真实实现。可在 MetaLite 源码中搜索 JdbcHelper.select 方法。）

    ---

    再看**注**。此处已经将原文中出现的大量未闭合标签与非法字符全部修正，以保证浏览器能完整渲染全文。

    ---

    与 .excludeField 而且两者互相冲突。 ）

    ---

    四、 字段投影不仅适用于列表，还适用于单条及分页

    java BaseDao dao;dao.findOneByQuery;// 单条 dao.findListByQuery;// 列表 dao.findListByQuery;// 分页列表

    所有上述接口均共享同一 #.query# 对象。实现方式统一，无需为不同返回列创建多套 Mapper 方法。

    注意PAGESIZE>^{*******\ 为框架内部定义的最大页面大小，用来阻止无分页意识的通用查询导致内存溢出。老实说，如果你想修改该值，只需在项目配置中覆盖对应常量即可。不过，}

    ---

    五、多数据源共通选择机制

    无论 JD娱乐 或 Elasticsearch。只要使用 #.query# 的 include / exclude 配置就可以完成：

    • JD娱乐 → 实际 SQL 列表；
    • Elasticsearch → source filtering；

    业务层无需关心底层实现细节，只关注「想要哪些列」即可。

    ---

    六、小心「不完整实体」陷阱

    因为你只是投影了一部分列，所以返回对象仍然是完整实体类。但未被选中的属性会保持 Java 默认值：

    属性类型	默认值
    引用类型	null
    数值原始类型	零

    这并不代表着数据库里真的存储了这些值，而仅表示「未读取」。：

    • 不建议把此对象直接用于全表更新；
    • 如需对「是否已读取」做区分，请使用包装类或自定义 DTO；
    • 对外接口最好做 DTO 映射，以免暴露内部实现细节。

    ---

    七、“MyBatis‑Plus Wrapper.select” 与 MetaLite 的区别

    Mybatis‑Plus 已经支持 Lambda 查询器中的 select 方法，一样可以避免硬编码字符串。但 MetaLite 的差异主要体现在：

    特点	Mybatis‑Plus	MetaLite
    字段投影方式	String / Lambda	Method reference + String
    查询构造器位置	Mapper 层	Common 模块统一
    数据源兼容	单一数据库	JD娱乐 + ES + 多租户
    DAO 接口语义	findOne / findAll 等自定义命名	findOneByQuery / findListByQuery 等统一

    如果项目已完全依赖 Mybatis‑Plus 且治理良好，迁移至 MetaLite 可视需求决定。

    ---

    八、本质调整目标不是语法，而是 默认行为 改进

    MetaLite 并不是发明新的「按需选取」机制。而是在通用 DAO 中把这项能力变成默认组成部分，并提供：

    • 方法引用友好的 API；
    • 最大行数/分页上限预设；
    • 多数据源共享同一 Query 对象；

    从而让团队更容易长期遵循「别写 Select *」这一常用方法，而不是每次都提醒开发者手动控制。

    ---

    框架简介

    MetaLite 是面向公司生产环境的新一代 Java 微服务技术底座。系列文章主要分享代码背后的设计思路、技术取舍与工程实践。

    源码基线

    JDK 11+,Spring Boot 5.x+,Spring Cloud 2024+。Spring Cloud Alibaba 2024+

    作者简介

    拥有十余年 Spring 公司级开发经验，专注于 Java 微服务架构治理与生产实践。

    持续更新

    MetaLite 系列内容将持续更新，围绕主要设计方案及源码链路展开。欢迎关注作者获取后续内容。

    在线演示

    演示地址的观点是，admin.metalite.top 至于演示账号，guess 说到演示密码。admin@