iOS VoiceOver播报accessibilityLabel时追加不明内容排查

这是iOS VoiceOver在重叠布局场景下的已知问题：你只手动给按钮开启无障碍权限、给其他重叠元素设置isAccessibilityElement = false，并不能阻止系统在动态更新控件accessibilityLabel时，错误把同层级/父视图范围内其他被覆盖元素的无障碍属性合并到当前焦点元素的播报流里。
你听到的“V X star”“Logo”这类无意义内容，本质是被覆盖的图片的默认无障碍标签——要么是图片资源的文件名被系统自动读取成了label，要么是开启了系统的图像识别功能自动生成的描述；“percent”这类内容一般是同层级下其他隐藏的状态类控件被错误扫进来的属性。

两步就能确认问题来源：

• 临时把重叠布局的图片从视图层级删掉，再测试播报，如果额外内容直接消失，就能确定是元素合并逻辑的问题
• 触发按钮label更新后，遍历打印按钮父视图下所有子视图的accessibilityLabel、accessibilityValue、accessibilityTraits，能直接匹配到那些无意义字符串对应的是哪个未被正确排除的元素

按优先级依次尝试，基本都能解决：

1. 不要只靠单独设置子元素的isAccessibilityElement控制无障碍可见性，显式给按钮所在的父容器指定可访问元素列表，强制VoiceOver跳过其他所有元素的扫描：

// 视图布局完成、所有子视图都添加完毕后调用
buttonContainerView.accessibilityElements = [myBtn]

2. 对重叠放置的UIImageView，除了设置isAccessibilityElement = false，额外清空它所有的无障碍相关属性，避免系统自动生成默认标签：

overlapImgView.accessibilityLabel = nil
overlapImgView.accessibilityValue = nil
overlapImgView.accessibilityHint = nil
overlapImgView.accessibilityTraits = []

3. 每次动态更新按钮的accessibilityLabel后，主动发送无障碍布局变更通知，刷新VoiceOver的元素缓存，避免旧的合并结果残留：

myBtn.accessibilityLabel = "Disconnected \(status)".localized
UIAccessibility.post(notification: .layoutChanged, argument: myBtn)

4. 兜底检查：确认按钮没有被误设置accessibilityAttributedLabel、accessibilityCustomActions这类带附加播报内容的属性，如果之前写过相关逻辑先清空，排除自定义属性拼接导致的多余播报。

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