iOS 17 Beta（Xcode 15 Beta）中UILabel圆角设置失效问题

问题背景 #

通过运行时属性给 UILabel 设置圆角以实现圆形显示，在 iOS 16.x 及以下版本正常生效，但 iOS 17 Beta 中圆形效果变成方形，多设备测试确认仅在该 Beta 环境出现问题。

可行解决方法 #

1. 改用代码直接设置圆角（推荐） #

放弃运行时属性，通过代码在合适的时机配置圆角：

• 固定尺寸的 UILabel，可在初始化或 viewDidLoad 中设置：

yourLabel.layer.cornerRadius = yourLabel.bounds.width / 2
yourLabel.layer.masksToBounds = true

• 使用 AutoLayout 动态布局时，需在 layoutSubviews 中更新圆角（确保布局完成后获取正确 bounds）：

class RoundLabel: UILabel {
    override func layoutSubviews() {
        super.layoutSubviews()
        layer.cornerRadius = bounds.width / 2
        layer.masksToBounds = true
    }
}

2. 补全运行时属性配置 #

若坚持使用运行时属性，需同时设置 layer.masksToBounds 为 true，iOS 17 Beta 中可能需要显式开启裁剪，才能让圆角生效。

3. 父容器包裹方案 #

用 UIView 作为 UILabel 的父容器，给父容器设置圆角和裁剪属性，让 UILabel 填充父容器：

let containerView = UIView(frame: yourLabel.frame)
containerView.layer.cornerRadius = containerView.bounds.width / 2
containerView.clipsToBounds = true
containerView.addSubview(yourLabel)

// 给 UILabel 添加约束使其填充容器
yourLabel.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    yourLabel.topAnchor.constraint(equalTo: containerView.topAnchor),
    yourLabel.leadingAnchor.constraint(equalTo: containerView.leadingAnchor),
    yourLabel.trailingAnchor.constraint(equalTo: containerView.trailingAnchor),
    yourLabel.bottomAnchor.constraint(equalTo: containerView.bottomAnchor)
])

问题原因推测 #

iOS 17 Beta 中苹果调整了 UIKit 控件对运行时属性的解析时机或 Layer 渲染逻辑，导致通过运行时设置的 cornerRadius 未被正确应用到最终布局后的控件上。Beta 版本存在此类兼容性问题属正常情况，后续正式版可能修复，但当前需通过上述方案规避。

内容的提问来源于stack exchange，提问作者Abhishek C. Gidde