iOS使用Auto Layout时报视图层级未准备好无法设置约束错误如何解决

报错原因 #

Thread 1: "Impossible to set up layout with view hierarchy unprepared for constraint."
该报错由以下几个问题共同触发：

• 视图添加顺序错误：代码中先给lbl1添加关联了父视图view的约束，之后才执行view.addSubview(lbl1)，此时lbl1和view不属于同一个视图层级，Auto Layout无法解析跨层级的约束，直接触发报错。
• 未关闭Autoresizing自动转换：代码创建的UI控件默认translatesAutoresizingMaskIntoConstraints = true，系统会自动将Autoresizing规则转换为约束，和手动添加的约束产生冲突。
• 约束添加位置错误：关联两个不同视图的约束不能直接添加到子视图上，需要添加到二者的公共父视图，手动指定添加位置极易出错。

修复代码 #

import UIKit

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad() // 符合生命周期规范必须调用父类方法
        view.backgroundColor = .blue
        lbl1values()
    }
    
    let lbl1 = UILabel()
    
    func lbl1values(){
        // 第一步：先把lbl1加入父视图，确保视图层级准备完成
        view.addSubview(lbl1)
        // 第二步：关闭Autoresizing自动转换，开启纯Auto Layout布局
        lbl1.translatesAutoresizingMaskIntoConstraints = false
        // 第三步：批量激活约束，无需手动指定添加到哪个视图
        NSLayoutConstraint.activate([
            lbl1.leading.constraint(equalTo: view.trailing, constant: 8),
            lbl1.top.constraint(equalTo: view.bottom, constant: -8)
            // 若需要lbl1正常显示，可补充宽高约束消除布局歧义，示例如下：
            // lbl1.width.constraint(equalToConstant: 120),
            // lbl1.height.constraint(equalToConstant: 30)
        ])
    }
}

核心改动说明 #

1. 调整视图添加顺序，先将子视图加入父视图层级后再添加约束
2. 显式关闭translatesAutoresizingMaskIntoConstraints，避免自动生成的约束冲突
3. 使用系统提供的约束批量激活API，无需手动管理约束的添加载体，降低出错概率
4. 补充调用super.viewDidLoad()，符合ViewController生命周期方法的调用规范

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