我要评论前言
问题的场景是偶尔出现某个查询接口查询出来的结果集不对，现象都是清一色的缺少条数，而且是偶发。
经过代码跟踪和复现，发现是pagehelper没有正确使用导致的上下文问题。
一、原因是什么
这个问题的根源通常出现在 pagehelper 的分页上下文没有被正确清理，导致分页上下文在没有显式调用 startpage 的情况下，影响了后续的查询执行。
二、可能原因及解决方案
1. pagehelper的上下文被意外继承
在 pagehelper.startpage 调用之后，如果你有条件判断导致某些 sql 查询没有执行，而其他查询方法仍然执行时，分页上下文可能会被错误地传递到这些查询中。
pagehelper 在后台会通过线程局部变量（threadlocal）来管理分页信息，如果分页上下文没有被清理，后续的查询可能会继承之前的分页设置。
解决方法：
使用 pagehelper.clearpage() 来手动清理分页上下文，确保分页信息不会影响到后续查询，尤其是条件判断没有执行 sql 时，避免影响到后面的查询。
// 调用分页
pagehelper.startpage(pagenum, pagesize);
// 条件判断
if (somecondition) {
// 不执行 sql 查询
} else {
// 执行 sql 查询
list<user> users = usermapper.selectusers();
}
// 清理分页上下文，防止影响后续查询
pagehelper.clearpage();这样，即使某些查询因条件判断未执行，pagehelper.clearpage() 会清理分页上下文，防止后续的查询（无论是否分页）受到影响。
2. 查询顺序或上下文未清理
如果在多个查询之间有分页设置，但是在其中一些查询没有执行时，pagehelper.startpage() 仍然可能对后续查询产生影响，导致它们不管是否显式设置分页，都采用了分页查询的上下文。
解决方法：
- 确保每个分页查询后都调用
pagehelper.clearpage()来清理分页上下文。 - 确保每个查询前都显式调用
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），分页设置可能会相互干扰。
例如，如果方法 a 中没有查询数据，而方法 b 中进行了查询，分页信息可能会被继承到方法 b。
解决方法：
确保每次分页查询之前，都显式调用 startpage，且每次分页查询后都清理分页上下文。
// 方法a
pagehelper.startpage(pagenum, pagesize);
if (somecondition) {
// 不执行查询
} else {
// 执行查询
list<user> users = usermapper.selectusers();
}
pagehelper.clearpage(); // 清理分页上下文
// 方法b
pagehelper.startpage(nextpagenum, nextpagesize);
list<order> orders = ordermapper.selectorders();
pagehelper.clearpage(); // 清理分页上下文4. 分页设置影响其他查询
由于 pagehelper 是基于线程局部变量（threadlocal）来管理分页上下文的，因此如果在方法之间传递分页设置，但没有清理，后续的查询可能会错误地继承分页设置，即使这些查询本身不需要分页。
解决方法：
- 确保在分页查询之后清理分页上下文。
- 在查询没有设置分页的情况下，确认没有隐式继承分页设置。
// 分页查询前显式调用startpage pagehelper.startpage(pagenum, pagesize); list<user> users = usermapper.selectusers(); // 清理分页上下文 pagehelper.clearpage(); // 非分页查询 list<order> orders = ordermapper.selectorders(); // 这时应该不再受分页影响
总结
- 清理分页上下文：每次分页查询结束后都调用
pagehelper.clearpage()来清理分页上下文，避免影响后续的查询。 - 确保分页设置生效：每次查询前都要确保分页设置已经正确调用
startpage。 - 避免条件判断影响分页：如果条件判断导致没有执行 sql 查询，确保分页上下文被清理，避免对后续查询产生影响。
通过这种方式，你可以确保分页逻辑不会意外地影响到后续的查询，即使某些查询由于条件判断而没有执行。
这些仅为个人经验，希望能给大家一个参考，也希望大家多多支持代码网。
发表评论