Android RecyclerView垂直滚动偏移异常，求替代computeVerticalScrollOffset方案

1. 使用LinearLayoutManager的getScrollY()（API 28+） #

如果应用最低支持API 28及以上，直接用LinearLayoutManager提供的getScrollY()方法，它返回RecyclerView实际的垂直滚动偏移，不受内容高度变化影响：

RecyclerView.OnScrollListener scrollListener = new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
        if (layoutManager == null) return;
        
        int scrollY = layoutManager.getScrollY();
        float alpha = Math.max(0f, Math.min(scrollY / 1000f, 1f));
        image.setAlpha(alpha);
    }
};

2. 兼容低版本：手动计算滚动偏移并维护累计值 #

对于低于API 28的版本，需要手动计算准确的滚动偏移，同时维护累计变量，在布局变化或滚动停止时修正值，避免跳变：

步骤1：初始化滚动监听与累计变量 #

private int mTotalScrollY = 0;
private RecyclerView.OnScrollListener scrollListener = new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        // 累加每次滚动的增量
        mTotalScrollY += dy;
        // 确保滚动值不小于0
        mTotalScrollY = Math.max(0, mTotalScrollY);
        
        updateImageAlpha();
    }

    @Override
    public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        // 滚动停止时修正累计值，消除误差
        if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            correctTotalScrollY(recyclerView);
        }
    }
};

步骤2：添加布局变化监听 #

当RecyclerView布局变化（如item高度改变、加载新item）时，重新计算准确的滚动偏移：

recyclerView.addOnLayoutChangeListener(new View.OnLayoutChangeListener() {
    @Override
    public void onLayoutChange(View v, int left, int top, int right, int bottom, int oldLeft, int oldTop, int oldRight, int oldBottom) {
        correctTotalScrollY((RecyclerView) v);
    }
});

步骤3：实现滚动值修正与透明度更新 #

private void correctTotalScrollY(RecyclerView recyclerView) {
    LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
    if (layoutManager == null) return;

    int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
    int correctedScrollY = 0;

    // 累加前面所有可见item的高度
    for (int i = 0; i < firstVisiblePos; i++) {
        View item = layoutManager.findViewByPosition(i);
        if (item != null) {
            correctedScrollY += layoutManager.getDecoratedMeasuredHeight(item);
        }
    }

    // 计算当前第一个可见item的偏移量
    View firstVisibleView = layoutManager.findViewByPosition(firstVisiblePos);
    if (firstVisibleView != null) {
        int itemTop = layoutManager.getDecoratedTop(firstVisibleView);
        correctedScrollY -= itemTop - recyclerView.getPaddingTop();
    }

    // 更新累计值，确保不小于0
    mTotalScrollY = Math.max(0, correctedScrollY);
    updateImageAlpha();
}

private void updateImageAlpha() {
    float alpha = Math.max(0f, Math.min(mTotalScrollY / 1000f, 1f));
    image.setAlpha(alpha);
}

为什么computeVerticalScrollOffset会跳变？ #

computeVerticalScrollOffset是基于RecyclerView的滚动范围（computeVerticalScrollRange）和可见范围（computeVerticalScrollExtent）计算的相对偏移值，当RecyclerView的内容高度发生变化（如item加载后高度调整、新增item），滚动范围会突然改变，导致计算出的偏移值出现跳变，无法准确反映实际的滚动位置。

内容的提问来源于stack exchange，提问作者Ziad Halabi