iOS带延迟动画Toast子视图初始帧位置异常问题求助

问题现象 #

• 使用UIView.animate的delay参数实现Toast延迟1秒淡出时，单个Toast显示正常，但快速连续调用showToast时，新创建的Toast会先显示在屏幕左上角(0,0)位置，直到延迟结束动画启动后才恢复到计算好的正确位置。
• 无延迟动画时，Toast布局正常但会立即淡出；尝试调用setNeedsLayout()和layoutIfNeeded()强制刷新布局，问题未解决。
• 改用DispatchQueue.main.asyncAfter替代动画的delay参数后，问题消失；但在独立测试Demo中无法复现该问题，怀疑是项目中其他代码影响导致。

可能的根源分析 #

• AutoLayout与手动frame的冲突：如果Toast类内部使用了AutoLayout约束，但外部通过init(frame:)直接设置frame，会存在布局优先级矛盾。延迟等待期间，系统可能触发AutoLayout刷新，覆盖手动设置的frame，导致视图回到(0,0)。
• 动画队列与布局刷新的时序问题：UIView.animate的延迟是由系统动画队列管理的，在等待延迟的1秒内，若项目中有全局布局刷新逻辑（比如父视图频繁调用layoutSubviews、其他AutoLayout动画触发），可能会重置Toast的frame。
• 父视图布局变化的影响：快速连续添加Toast时，父视图可能因其他子视图的变化正在执行布局更新，此时新加入的Toast的frame尚未被稳定记录，在延迟期间被父视图的布局逻辑覆盖。
• RunLoop调度差异：UIView.animate的延迟处理和DispatchQueue.main.asyncAfter的调度时机不同，前者属于动画系统队列，后者属于主队列RunLoop周期调度，后者可能避开了触发布局重置的时机。

排查方向 #

1. 检查Toast内部实现：确认是否使用AutoLayout约束，若使用则不应直接通过init(frame:)设置frame，需改用约束布局并强制刷新。
2. 追踪布局变化：在Toast的layoutSubviews方法中打印frame值，查看延迟期间是否有被修改为(0,0)，定位触发布局刷新的来源。
3. 排查父视图逻辑：检查主视图（view）的layoutSubviews是否有自定义逻辑，或是否有其他子视图频繁触发布局更新，影响新添加的Toast。
4. 检查全局Hook：确认项目中是否通过Method Swizzling修改了UIView的setFrame:、layoutSubviews等方法，导致frame被意外修改。
5. 隔离测试验证：在项目中新建空白ViewController，仅保留Toast相关代码，快速调用看是否复现；逐步加入项目中的全局配置、第三方库等，定位影响代码块。

修复方案 #

方案1：用DispatchQueue.main.asyncAfter替代动画延迟参数（已验证有效） #

func showToast(_ message: String) {
  let frame = computeToastFrame()
  let toast = Toast(frame: frame)
  view.addSubview(toast)
  
  DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
    UIView.animate(withDuration: 1, options: .allowUserInteraction) {
      toast.alpha = 0.02
    } completion: { _ in
      toast.removeFromSuperview()
    }
  }
}

方案2：统一使用AutoLayout约束布局 #

如果Toast内部依赖AutoLayout，改用约束布局并强制刷新确保位置稳定：

func showToast(_ message: String) {
  let toast = Toast()
  toast.translatesAutoresizingMaskIntoConstraints = false
  view.addSubview(toast)
  
  // 根据需求添加约束示例（居中、底部间距、左右边距）
  NSLayoutConstraint.activate([
    toast.centerXAnchor.constraint(equalTo: view.centerXAnchor),
    toast.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -20),
    toast.leadingAnchor.constraint(greaterThanOrEqualTo: view.leadingAnchor, constant: 20),
    toast.trailingAnchor.constraint(lessThanOrEqualTo: view.trailingAnchor, constant: -20)
  ])
  
  // 强制刷新布局，确保约束生效后再添加动画
  view.layoutIfNeeded()
  
  DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
    UIView.animate(withDuration: 1, options: .allowUserInteraction) {
      toast.alpha = 0.02
    } completion: { _ in
      toast.removeFromSuperview()
    }
  }
}

方案3：禁用自动布局转换 #

若坚持使用frame初始化，关闭Toast的translatesAutoresizingMaskIntoConstraints，避免父视图布局时自动生成约束覆盖手动frame：

func showToast(_ message: String) {
  let frame = computeToastFrame()
  let toast = Toast(frame: frame)
  toast.translatesAutoresizingMaskIntoConstraints = false
  view.addSubview(toast)
  
  DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
    UIView.animate(withDuration: 1, options: .allowUserInteraction) {
      toast.alpha = 0.02
    } completion: { _ in
      toast.removeFromSuperview()
    }
  }
}

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