iPhone 13 Pro Max下CAGradientLayer渐变无法铺满宽视图右侧留空问题求解

• 你在重写viewDidLayoutSubviews()时遗漏了super.viewDidLayoutSubviews()调用，导致获取视图bounds时布局还未完全计算完成。iPhone 13 Pro Max 这类大屏设备的布局计算链路比小屏设备更长，没有父类方法调用时拿到的是布局更新前的旧宽度，刚好约为大屏宽度的80%，因此出现右侧留白、渐变左偏移的问题，小屏设备因为旧bounds刚好和最终尺寸一致，所以没有暴露出问题。
• CAGradientLayer 属于 Core Animation 层，不会自动跟随宿主视图的 bounds 变化更新自身 frame，你每次手动重建渐变层的方式容易因为时机偏差拿到错误的尺寸。
• 部分3倍屏设备下渐变层默认contentsScale为1，没有匹配设备的屏幕缩放系数，也可能引发尺寸渲染偏移。

1. 优先修复控制器的布局调用逻辑 #

确保viewDidLayoutSubviews优先调用父类方法，保证获取bounds时布局已经完全更新：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    self.viewTAGradient.applyGradientDiagonal(isVertical: false, colorArray: [UIColor.init(named: "gradient1")!, UIColor.init(named: "gradient2")!, UIColor.init(named: "gradient3")!])
}

做完这一步通常就可以解决你当前的特定设备偏移问题。

2. 优化渐变实现（可选，彻底避免同类问题） #

优化渐变扩展逻辑，自动跟随视图bounds更新，无需每次重建层：

import UIKit
import ObjectiveC

extension UIView {
    private struct AssociatedKeys {
        static var gradientLayer = "gradientLayer"
    }
    
    private var gradientLayer: CAGradientLayer? {
        get {
            objc_getAssociatedObject(self, &AssociatedKeys.gradientLayer) as? CAGradientLayer
        }
        set {
            objc_setAssociatedObject(self, &AssociatedKeys.gradientLayer, newValue, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
        }
    }
    
    func applyGradientDiagonal(isVertical: Bool, colorArray: [UIColor]) {
        // 复用已有渐变层，避免重复创建移除
        let gradientLayer: CAGradientLayer
        if let existing = gradientLayer {
            gradientLayer = existing
        } else {
            gradientLayer = CAGradientLayer()
            self.gradientLayer = gradientLayer
            gradientLayer.contentsScale = UIScreen.main.scale
            backgroundColor = .clear
            layer.insertSublayer(gradientLayer, at: 0)
        }
        
        gradientLayer.colors = colorArray.map(\.cgColor)
        if isVertical {
            gradientLayer.locations = [0.0, 1.0]
        } else {
            gradientLayer.startPoint = CGPoint(x: 0, y: 0)
            gradientLayer.endPoint = CGPoint(x: 1, y: 1)
        }
        gradientLayer.frame = bounds
    }
    
    // 重写布局方法，自动更新渐变层尺寸
    open override func layoutSubviews() {
        super.layoutSubviews()
        gradientLayer?.frame = bounds
    }
}

优化后你只需要在viewDidLoad中调用一次渐变方法即可，后续视图尺寸变化会自动适配。

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