根据滚动位置修改backBarButtonItem的tint颜色不生效原因及解决方案

问题背景 #

• 需求：根据UIScrollView的滚动偏移量动态调整导航栏返回按钮的tint颜色，滚动未达阈值时按钮显示黄色，超过阈值后切换为红色
• 异常表现：通过断点验证滚动计算逻辑、分支判断逻辑均正常触发，对应的颜色设置代码执行无报错，但返回按钮始终保持初始的黄色，从未切换为红色
• 初始猜测：是否backBarButtonItem完成初始化后，就无法再修改其属性

对应实现代码如下：

CGFloat totalHeight = CGRectGetMaxY(self.frame);
    CGFloat barHeight = CGRectGetHeight(self.frame);

    CGFloat offsetHeight = (self.scrollview.contentOffset.y - self.scrollViewMinimumOffset) + totalHeight;
    offsetHeight = MAX(offsetHeight, 0.0f);
    offsetHeight = MIN(offsetHeight, totalHeight);
    
    if (offsetHeight > barHeight * 1.0f) {
        [self.backBarButtonItem setTintColor:[UIColor redColor]];
    } else {
        [self.backBarButtonItem setTintColor:[UIColor yellowColor]];
    }

核心原因说明 #

首先可以明确：backBarButtonItem 初始化完成后并非完全不可修改，绝大多数改色无效的场景，都是因为对UIBarButtonItem的生效层级、渲染规则存在认知偏差

• 第一点：你修改的对象根本不是页面上实际渲染的返回按钮
  系统的navigationItem.backBarButtonItem存在特殊的生效规则：当前控制器在自身navigationItem上设置的backBarButtonItem，只会对后续被push进来的下一个控制器生效，不会影响当前控制器自己导航栏上显示的返回按钮。你在页面内修改自己持有的backBarButtonItem实例，改的是一个根本不会在当前页面渲染的空对象，自然看不到任何颜色变化。
• 第二点：tint颜色的继承优先级问题
  就算你改对了barButtonItem实例，UINavigationBar本身的tintColor优先级是高于单个barItem的。系统会沿视图层级向下传递导航栏的tintColor值，只要你没有在修改barItem的tintColor时打断继承链，这个值就会被导航栏的全局tintColor覆盖，尤其是iOS13之后UIKit的配色体系收紧后，这种覆盖行为会更频繁。
• 第三点：iOS13+的外观缓存拦截
  如果你之前通过UINavigationBarAppearance做过全局导航栏外观配置，系统会缓存外观配置的所有属性值，手动给barItem设置的tintColor会被缓存的外观规则拦截，不会实时渲染到页面上。

可落地的正确实现方式 #

• 优先走系统原生的颜色传递链路：放弃直接操作自定义持有backBarButtonItem的方式，直接动态修改导航栏本身的tintColor。因为系统原生返回按钮的颜色完全跟随导航栏tintColor渲染，这个链路是系统打通的，没有中间对象的拦截问题，只要把原代码里的颜色设置语句改成对导航栏tintColor的赋值即可正常生效。
• 适配iOS13+的外观配置场景：如果项目用了UINavigationBarAppearance做全局样式配置，需要在动态改色时同步更新外观实例中返回按钮对应的tintColor值，修改完成后调用导航栏的setNeedsLayout方法触发界面刷新，避免被外观缓存拦截。
• 独立样式定制场景：如果需要返回按钮的颜色不随导航栏其他控件的tintColor变化，可以把系统原生返回按钮替换为自定义的leftBarButtonItem。这个自定义的按钮实例完全由你持有、直接渲染在当前导航栏上，给它设置tintColor可以实时生效，不会被系统的返回按钮特殊渲染逻辑拦截。

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