如何基于日期实现Android ViewPager与FragmentStatePagerAdapter无限滚动？

开发者阿泽

2026-5-22

解决ViewPager+FragmentStatePagerAdapter日期页面滚动异常的问题

我之前做类似日期切换的待办App时也碰到过一模一样的坑，你的问题大概率是这几个常见原因导致的，咱们一步步来排查修复：

先检查getItem()的日期映射逻辑
很多人在这里栽跟头：没有根据position准确计算对应日期，比如把昨日、今日、明日的索引搞混了，或者日期计算逻辑出错。举个例子，你可以明确position和日期的对应关系：
```
private LocalDate getDateForPosition(int position) {
    LocalDate today = LocalDate.now();
    switch(position) {
        case 0: return today.minusDays(1); // 昨日
        case 1: return today; // 今日
        case 2: return today.plusDays(1); // 明日
        default: return today;
    }
}
```
然后在getItem()里用这个方法生成对应日期的Fragment，绝对不要硬编码日期或者复用错误的Fragment实例。
确认getCount()返回值正确
你现在是3个日期页面，一定要确保getCount()返回3，别手滑写成其他数字，否则ViewPager的滚动逻辑会直接混乱。
重写getItemId()避免页面复用错误
FragmentStatePagerAdapter默认用position作为页面的唯一标识，当滚动时如果position和日期的对应关系出现偏移（比如后续扩展更多日期），就会导致加载错误的页面。建议重写这个方法，返回和日期绑定的唯一值，比如日期的时间戳：
```
@Override
public long getItemId(int position) {
    LocalDate targetDate = getDateForPosition(position);
    return targetDate.toEpochDay(); // 用日期的EpochDay作为唯一ID
}
```
这样Adapter就能根据日期本身识别页面，而不是单纯依赖position。

检查Fragment的参数传递与数据加载
确保Fragment是通过参数接收日期，而不是硬编码或者共享变量。比如创建Fragment时用静态方法传递日期参数：

public static TaskFragment newInstance(LocalDate date) {
    TaskFragment fragment = new TaskFragment();
    Bundle args = new Bundle();
    args.putSerializable("TARGET_DATE", date);
    fragment.setArguments(args);
    return fragment;
}

然后在Fragment的onCreate()或onCreateView()里取出参数，再加载对应日期的任务：

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    if (getArguments() != null) {
        mTargetDate = (LocalDate) getArguments().getSerializable("TARGET_DATE");
        loadTasksForDate(mTargetDate); // 根据日期加载任务
    }
}

确认ViewPager的缓存设置
ViewPager默认会缓存左右各1个页面，对于3个页面来说这个缓存是足够的，但如果之前修改过setOffscreenPageLimit()设成0，会导致页面频繁销毁重建，出现异常。可以手动设置为2（覆盖所有3个页面）：
```
mViewPager.setOffscreenPageLimit(2);
```

按照这几步排查下来，应该就能解决你滚动时页面加载异常的问题了。

内容的提问来源于stack exchange，提问作者Przemysław Moskal