// 產(chǎn)品實(shí)體類
@Data
public class Product {
    private Long id;
    private String name;
    private BigDecimal price;
    private Integer stock;
}
// 數(shù)據(jù)訪問接口
@Mapper
public interface ProductMapper extends BaseMapper<Product> {
}
// 業(yè)務(wù)代碼示例
@Service
public class ProductService {
    @Autowired
    private ProductMapper productMapper;
    public void processInactiveProducts() {
        // 只查詢價格和庫存字段，沒有包含主鍵id
        QueryWrapper<Product> wrapper = new QueryWrapper<>();
        wrapper.select("price", "stock")
               .eq("status", "INACTIVE");
        List<Product> products = productMapper.selectList(wrapper);
        // 如果某行記錄中price和stock字段都為NULL
        // 則products列表中對應(yīng)元素可能為null
        for (Product product : products) {
            // 當(dāng)product為null時，此處會拋出NullPointerException
            System.out.println("庫存數(shù)量：" + product.getStock());
        }
    }
}

// 簡化后的核心邏輯
public Object getRowValue(ResultSetWrapper rsw, ResultMap resultMap) {
    // 1. 嘗試創(chuàng)建目標(biāo)類型的對象實(shí)例
    Object rowValue = createResultObject(rsw, resultMap);
    // 2. 進(jìn)行屬性映射，判斷是否找到了有效值
    boolean foundValues = applyPropertyMappings(rsw, resultMap, rowValue);
    // 3. 決定性判斷：是否有找到值 或 配置要求返回空行實(shí)例
    if (!foundValues && !configuration.isReturnInstanceForEmptyRow()) {
        return null;  // 既沒有值也不要求返回實(shí)例 → 返回null
    }
    return rowValue;  // 返回對象實(shí)例（可能是屬性全為null的對象）
}

// 推薦做法：始終包含主鍵或非空字段
public List<Product> getProductsSafely() {
    QueryWrapper<Product> wrapper = new QueryWrapper<>();
    // 方式1：顯式包含非空字段
    wrapper.select("id", "name", "price");
    // 方式2：使用Lambda表達(dá)式，避免字段名硬編碼
    wrapper.select(Product.class, tableFieldInfo -> 
        !tableFieldInfo.getColumn().equals("deleted_flag"));
    // 方式3：如果必須只查可能為NULL的字段，添加COALESCE確保非空
    wrapper.select("id", 
                   "COALESCE(price, 0) as price", 
                   "COALESCE(stock, 0) as stock");
    return productMapper.selectList(wrapper);
}

// 工具類方法：安全處理查詢結(jié)果
public class QueryResultUtils {
    /**
     * 確保查詢結(jié)果列表中沒有null元素
     * @param originalList 原始查詢結(jié)果
     * @param emptyInstanceSupplier 空對象供應(yīng)函數(shù)
     * @return 安全的列表，不含null元素
     */
    public static <T> List<T> ensureNoNullElements(
            List<T> originalList, 
            Supplier<T> emptyInstanceSupplier) {
        if (originalList == null || originalList.isEmpty()) {
            return Collections.emptyList();
        }
        return originalList.stream()
                .map(item -> item != null ? item : emptyInstanceSupplier.get())
                .collect(Collectors.toList());
    }
    /**
     * 過濾掉null元素
     */
    public static <T> List<T> filterNullElements(List<T> originalList) {
        if (originalList == null) {
            return Collections.emptyList();
        }
        return originalList.stream()
                .filter(Objects::nonNull)
                .collect(Collectors.toList());
    }
}
// 使用示例
public class ProductService {
    public void processProductsSafely() {
        QueryWrapper<Product> wrapper = new QueryWrapper<>();
        wrapper.select("price", "stock");
        List<Product> rawProducts = productMapper.selectList(wrapper);
        // 方法1：用空對象替換null
        List<Product> safeProducts = QueryResultUtils.ensureNoNullElements(
            rawProducts, 
            Product::new
        );
        // 方法2：直接過濾null元素（可能改變列表大?。?
        List<Product> filteredProducts = QueryResultUtils.filterNullElements(rawProducts);
        // 方法3：使用Optional進(jìn)行鏈?zhǔn)秸{(diào)用
        rawProducts.stream()
                  .map(Optional::ofNullable)
                  .forEach(optProduct -> {
                      optProduct.ifPresent(product -> {
                          // 安全操作
                          System.out.println(product.getStock());
                      });
                  });
    }
}

# application.yml 配置方式
mybatis-plus:
  configuration:
    # 控制當(dāng)所有列值為空時是否返回對象實(shí)例
    return-instance-for-empty-row: true
  global-config:
    db-config:
      # 其他相關(guān)配置
      logic-delete-field: deleted  # 邏輯刪除字段名
      logic-delete-value: 1        # 邏輯已刪除值
      logic-not-delete-value: 0    # 邏輯未刪除值

<!-- mybatis-config.xml -->
<configuration>
  <settings>
    <!-- 設(shè)置為true時，即使沒有列映射到屬性也返回對象實(shí)例 -->
    <setting name="returnInstanceForEmptyRow" value="true"/>
    <!-- 其他相關(guān)設(shè)置 -->
    <setting name="mapUnderscoreToCamelCase" value="true"/>
  </settings>
</configuration>

// 自定義結(jié)果處理器
@Component
public class SafeResultHandler<T> implements ResultHandler<T> {
    private final List<T> resultList = new ArrayList<>();
    private final Supplier<T> emptyInstanceSupplier;
    public SafeResultHandler(Supplier<T> emptyInstanceSupplier) {
        this.emptyInstanceSupplier = emptyInstanceSupplier;
    }
    @Override
    public void handleResult(ResultContext<? extends T> resultContext) {
        T resultObject = resultContext.getResultObject();
        if (resultObject == null) {
            resultList.add(emptyInstanceSupplier.get());
        } else {
            resultList.add(resultObject);
        }
    }
    public List<T> getResultList() {
        return Collections.unmodifiableList(resultList);
    }
}
// 使用自定義處理器
public class ProductService {
    public List<Product> getProductsWithHandler() {
        QueryWrapper<Product> wrapper = new QueryWrapper<>();
        wrapper.select("price", "stock");
        SafeResultHandler<Product> resultHandler = 
            new SafeResultHandler<>(Product::new);
        // 使用MyBatis的原生查詢方式
        productMapper.selectList(wrapper, resultHandler);
        return resultHandler.getResultList();
    }
}

// 在項(xiàng)目公共模塊中定義安全查詢工具類
public class MyBatisPlusSafeQuery {
    /**
     * 安全的查詢列表方法，自動處理null元素
     */
    public static <T> List<T> selectListSafe(
            BaseMapper<T> mapper, 
            QueryWrapper<T> wrapper,
            Supplier<T> emptyInstanceSupplier) {
        List<T> result = mapper.selectList(wrapper);
        return Optional.ofNullable(result)
                .orElse(Collections.emptyList())
                .stream()
                .map(item -> item != null ? item : emptyInstanceSupplier.get())
                .collect(Collectors.toList());
    }
}

@SpringBootTest
public class ProductQueryTest {
    @Test
    public void testSelectListWithAllNullFields() {
        // 模擬所有查詢字段都為NULL的數(shù)據(jù)
        Product product = new Product();
        product.setPrice(null);
        product.setStock(null);
        productMapper.insert(product);
        QueryWrapper<Product> wrapper = new QueryWrapper<>();
        wrapper.select("price", "stock")
               .eq("id", product.getId());
        // 測試原始方法
        List<Product> rawResult = productMapper.selectList(wrapper);
        assertThat(rawResult).isNotEmpty();
        // 測試安全包裝方法
        List<Product> safeResult = MyBatisPlusSafeQuery.selectListSafe(
            productMapper, wrapper, Product::new);
        assertThat(safeResult)
            .isNotEmpty()
            .allMatch(Objects::nonNull);
    }
}