iOS Swift约束不生效，UITableView子视图设translatesAutoresizingMaskIntoConstraints=false后消失

问题描述 #

在iOS Swift开发中遇到自动布局约束不生效的问题：UITableView的子视图设置translatesAutoresizingMaskIntoConstraints = false后直接消失，有代码创建约束的经验但无法定位原因，相关代码如下：

override func viewDidLoad() {
    super.viewDidLoad()

    let imageview = UIImageView(image: UIImage(named: "dollarsign"))
    //imageview.translatesAutoresizingMaskIntoConstraints = false
    
    imageview.backgroundColor = UIColor(red: 0, green: 1, blue: 0, alpha: 0.10)
    self.view.addSubview(imageview)
    self.view.bringSubviewToFront(imageview)
    
    imageview.trailingAnchor.constraint(equalTo: self.view.trailingAnchor, constant: 0).isActive = true
    imageview.bottomAnchor.constraint(equalTo: self.view.bottomAnchor, constant: 0).isActive = true
    
    imageview.widthAnchor.constraint(equalToConstant: 320).isActive = true
    imageview.heightAnchor.constraint(equalToConstant: 480).isActive = true
}

当注释掉imageview.translatesAutoresizingMaskIntoConstraints = false代码行时，图片视图可以正常显示，默认位于(0,0)坐标，宽高为自身资源的自然尺寸。

不需要系统自动生成约束，因此取消该行注释让手动编写的约束生效后，UIImageView就直接消失了：

补充排查信息 #

已经设置约束将图片视图与父视图的trailing、bottom锚点绑定，但约束生效后图片视图的位置偏移到(-320,-480)，相关日志代码如下：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    print("image view frame: \(imageview.frame)")
}

image view frame: (-320.0, -480.0, 320.0, 480.0)

问题原因与解决方案 #

问题核心出在约束计算时父视图（当前控制器的self.view）的尺寸为0，导致你设置的对齐约束最终算出的子视图位置超出了屏幕可见区域：

• 你设置imageView.trailing等于self.view.trailing，当self.view的宽度为0时，self.view.trailing的值就是0，对应imageView的x坐标就等于0 - 320 = -320
• 同理self.view高度为0时，imageView的y坐标等于0 - 480 = -480，最终整个视图完全位于屏幕左上角以外的不可见区域

排查步骤 #

1. 首先确认当前控制器的view是否已正确挂载：如果你是把当前控制器作为子控制器添加到其他控制器，必须给当前控制器的view添加有效约束，保证其尺寸、位置正确，否则它自身尺寸为0会导致所有子视图约束计算异常
2. 如果你是直接使用当前控制器作为根控制器，排查是否在其他地方修改了self.view的默认尺寸约束，或者有约束冲突导致self.view尺寸被压为0，可以在viewDidAppear里打印self.view.frame确认：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    print("self.view frame: \(self.view.frame)")
    print("image view frame: \(imageview.frame)")
}

3. 额外注意：你当前代码里的imageview是viewDidLoad内的局部变量，后续要访问它的话需要提升为控制器的全局属性，否则出了viewDidLoad作用域后你只能通过view.subviews遍历找到它。

临时验证方案 #

你可以把约束暂时换成和父视图的leading、top对齐，确认是否能正常显示：

// 替换原来的trailing、bottom约束
imageview.leadingAnchor.constraint(equalTo: self.view.leadingAnchor, constant: 0).isActive = true
imageview.topAnchor.constraint(equalTo: self.view.topAnchor, constant: 0).isActive = true

如果替换后图片显示在屏幕左上角，就可以100%确认是self.view本身尺寸为0的问题。

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