前言

問題的場景是偶爾出現(xiàn)某個查詢接口查詢出來的結(jié)果集不對，現(xiàn)象都是清一色的缺少條數(shù)，而且是偶發(fā)。

經(jīng)過代碼跟蹤和復(fù)現(xiàn)，發(fā)現(xiàn)是PageHelper沒有正確使用導(dǎo)致的上下文問題。

一、原因是什么

這個問題的根源通常出現(xiàn)在 PageHelper 的分頁上下文沒有被正確清理，導(dǎo)致分頁上下文在沒有顯式調(diào)用 startPage 的情況下，影響了后續(xù)的查詢執(zhí)行。

二、可能原因及解決方案

1. PageHelper的上下文被意外繼承

在 PageHelper.startPage 調(diào)用之后，如果你有條件判斷導(dǎo)致某些 SQL 查詢沒有執(zhí)行，而其他查詢方法仍然執(zhí)行時，分頁上下文可能會被錯誤地傳遞到這些查詢中。

PageHelper 在后臺會通過線程局部變量（ThreadLocal）來管理分頁信息，如果分頁上下文沒有被清理，后續(xù)的查詢可能會繼承之前的分頁設(shè)置。

解決方法：

使用 PageHelper.clearPage() 來手動清理分頁上下文，確保分頁信息不會影響到后續(xù)查詢，尤其是條件判斷沒有執(zhí)行 SQL 時，避免影響到后面的查詢。

// 調(diào)用分頁
PageHelper.startPage(pageNum, pageSize);

// 條件判斷
if (someCondition) {
    // 不執(zhí)行 SQL 查詢
} else {
    // 執(zhí)行 SQL 查詢
    List<User> users = userMapper.selectUsers();
}

// 清理分頁上下文，防止影響后續(xù)查詢
PageHelper.clearPage();

這樣，即使某些查詢因條件判斷未執(zhí)行，PageHelper.clearPage() 會清理分頁上下文，防止后續(xù)的查詢（無論是否分頁）受到影響。

2. 查詢順序或上下文未清理

如果在多個查詢之間有分頁設(shè)置，但是在其中一些查詢沒有執(zhí)行時，PageHelper.startPage() 仍然可能對后續(xù)查詢產(chǎn)生影響，導(dǎo)致它們不管是否顯式設(shè)置分頁，都采用了分頁查詢的上下文。

解決方法：

• 確保每個分頁查詢后都調(diào)用 PageHelper.clearPage() 來清理分頁上下文。
• 確保每個查詢前都顯式調(diào)用 startPage。

// 分頁查詢1
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.selectUsers();
PageHelper.clearPage();  // 清理分頁上下文

// 分頁查詢2
PageHelper.startPage(nextPageNum, nextPageSize);
List<Order> orders = orderMapper.selectOrders();
PageHelper.clearPage();  // 清理分頁上下文

3. 在多個方法之間使用分頁時，未正確分離上下文

如果你在多個方法中使用了分頁，并且沒有在分頁查詢之間清理上下文（clearPage），分頁設(shè)置可能會相互干擾。

例如，如果方法 A 中沒有查詢數(shù)據(jù)，而方法 B 中進(jìn)行了查詢，分頁信息可能會被繼承到方法 B。

解決方法：

確保每次分頁查詢之前，都顯式調(diào)用 startPage，且每次分頁查詢后都清理分頁上下文。

// 方法A
PageHelper.startPage(pageNum, pageSize);
if (someCondition) {
    // 不執(zhí)行查詢
} else {
    // 執(zhí)行查詢
    List<User> users = userMapper.selectUsers();
}
PageHelper.clearPage(); // 清理分頁上下文

// 方法B
PageHelper.startPage(nextPageNum, nextPageSize);
List<Order> orders = orderMapper.selectOrders();
PageHelper.clearPage(); // 清理分頁上下文

4. 分頁設(shè)置影響其他查詢

由于 PageHelper 是基于線程局部變量（ThreadLocal）來管理分頁上下文的，因此如果在方法之間傳遞分頁設(shè)置，但沒有清理，后續(xù)的查詢可能會錯誤地繼承分頁設(shè)置，即使這些查詢本身不需要分頁。

解決方法：

• 確保在分頁查詢之后清理分頁上下文。
• 在查詢沒有設(shè)置分頁的情況下，確認(rèn)沒有隱式繼承分頁設(shè)置。

// 分頁查詢前顯式調(diào)用startPage
PageHelper.startPage(pageNum, pageSize);
List<User> users = userMapper.selectUsers();

// 清理分頁上下文
PageHelper.clearPage();

// 非分頁查詢
List<Order> orders = orderMapper.selectOrders(); // 這時應(yīng)該不再受分頁影響

總結(jié)

1. 清理分頁上下文：每次分頁查詢結(jié)束后都調(diào)用 PageHelper.clearPage() 來清理分頁上下文，避免影響后續(xù)的查詢。
2. 確保分頁設(shè)置生效：每次查詢前都要確保分頁設(shè)置已經(jīng)正確調(diào)用 startPage。
3. 避免條件判斷影響分頁：如果條件判斷導(dǎo)致沒有執(zhí)行 SQL 查詢，確保分頁上下文被清理，避免對后續(xù)查詢產(chǎn)生影響。

通過這種方式，你可以確保分頁邏輯不會意外地影響到后續(xù)的查詢，即使某些查詢由于條件判斷而沒有執(zhí)行。

這些僅為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論