BaseMapper的selectList查不到数据主因是字段命名策略未开启驼峰转下划线或QueryWrapper字段名用数据库列名而非实体属性名；需配置map-underscore-to-camel-case=true，且wrapper中使用userName而非user_name。
BaseMapper 的 selectList 为什么查不到数据？
不是 SQL 写错了，大概率是条件没生效或实体字段没对齐。MyBatis-Plus 的 BaseMapper 默认用属性名匹配数据库列名，不自动做驼峰转下划线——除非你显式开启。
- 检查是否在
application.yml中配置了mybatis-plus.configuration.map-underscore-to-camel-case=true -
QueryWrapper构造时，传入的字段名必须是 Java 实体属性名，不是数据库列名；比如实体有userName，就写wrapper.eq("userName", "zhang")，别写"user_name" - 空值字段不会被拼进 SQL，
eq("status", null)直接被忽略，要用isNull("status") - 如果用了
@TableField(exist = false)，它也不会参与查询，哪怕你在 wrapper 里写了这个字段名
代码生成器生成的 Entity 和 Mapper 怎么快速接入项目？
生成器本身不负责注册 Bean，也不自动扫描 Mapper 接口——这一步漏了，BaseMapper 方法调用会直接报 BeanCreationException 或 No qualifying bean。
- 确保生成的
Mapper接口继承了BaseMapper<yourentity></yourentity>，且接口上加了@Mapper注解，或者在启动类上用@MapperScan("com.xxx.mapper")扫描包路径 - 生成的
Entity类必须有无参构造函数（Lombok 的@Data默认提供，但若手动写了有参构造，得补上@NoArgsConstructor） - 数据库字段类型映射要核对：比如 MySQL 的
datetime对应 Java 的LocalDateTime，不是Date；生成器默认按类型推断，但时区或精度不一致会导致查出来为 null - 生成器模板里若关闭了
enableTableFieldAnnotation，字段就不会带@TableField，遇到列名和属性名不一致时会查不到数据
IService 和 BaseMapper 到底该用哪个？
不是“更高级就更好”，而是看场景：简单单表 CRUD 用 BaseMapper 更轻量；需要事务控制、批量逻辑、前后置钩子，就绕不开 IService。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
BaseMapper是接口，方法都是单条 SQL 映射，不带事务——你自己调insert()后再抛异常，数据已经写进去了 -
IService默认实现类ServiceImpl把BaseMapper包了一层，所有方法都加了@Transactional（默认传播行为REQUIRED），适合服务层编排 - 自定义 service 方法想复用
BaseMapper，别直接 new Mapper 实现类，而是通过构造注入或@Autowired拿到 mapper 实例 - 如果用了
saveBatch这类批量方法，注意 MySQL 的rewriteBatchedStatements=true参数没配的话，性能可能比循环插入还差
生成器输出的 Controller 能不能直接用？
能跑，但上线前几乎都要删——它只解决“能动”，不解决“该怎么动”。特别是参数校验、权限、分页封装、异常统一处理这些，生成器一概不管。
立即学习“Java免费学习笔记（深入）”；
- 生成的
save方法直接接收Entity，没做参数校验，前端传个超长字符串或非法枚举值，后端就直接插库失败 - 分页用的是
Page对象，但前端传参格式（如current=1&size=10）需要配合PageHandler或自定义Resolver，否则Page里records为空 - 生成的
removeById不校验用户是否有权限删这条数据，也不记录操作日志，线上出问题没法追溯 - 如果实体里有敏感字段（如密码），生成的
update方法会把整个对象全量更新，可能误清空非空字段
