使用SecureField切换输入框时模拟器出现LayoutConstraints约束冲突错误

问题重现 #

在iOS模拟器中，切换包含两个TextField和一个SecureField的输入框时，控制台会输出布局约束冲突错误。移除SecureField后错误消失。

相关代码 #

import SwiftUI

struct RootView: View {
    @State var email: String = ""
    @State var name: String = ""
    @State var password: String = ""
    
    var body: some View {
        VStack {
            TextField("邮箱", text: $email)
            TextField("姓名", text: $name)
            SecureField("密码", text: $password)
        }
    }
}

错误日志 #

2023-02-22 19:04:50.488739+0800 newapp[1610:726583] [LayoutConstraints] 无法同时满足多个约束条件。
    以下列表中至少有一个约束是你不需要的。
    尝试以下操作：
        (1) 检查每个约束，找出不符合预期的项；
        (2) 定位添加多余约束的代码并修复。
(
    "<NSLayoutConstraint:0x2803a9cc0 'accessoryView.bottom' _UIRemoteKeyboardPlaceholderView:0x102a2d580.bottom == _UIKBCompatInputView:0x102b19000.top   (active)>",
    "<NSLayoutConstraint:0x2803dbd90 'assistantHeight' SystemInputAssistantView.height == 45   (active, names: SystemInputAssistantView:0x102b0ccd0 )>",
    "<NSLayoutConstraint:0x2803dd130 'assistantView.bottom' SystemInputAssistantView.bottom == _UIKBCompatInputView:0x102b19000.top   (active, names: SystemInputAssistantView:0x102b0ccd0 )>",
    "<NSLayoutConstraint:0x2803dd0e0 'assistantView.top' V:[_UIRemoteKeyboardPlaceholderView:0x102a2d580]-(0)-[SystemInputAssistantView]   (active, names: SystemInputAssistantView:0x102b0ccd0 )>",
)

将尝试通过打破以下约束来恢复：
<NSLayoutConstraint:0x2803dd0e0 'assistantView.top' V:[_UIRemoteKeyboardPlaceholderView:0x102a2d580]-(0)-[SystemInputAssistantView]   (active, names: SystemInputAssistantView:0x102b0ccd0 )>

可以在`UIViewAlertForUnsatisfiableConstraints`设置符号断点，在调试器中捕获该问题。
<UIKitCore/UIView.h>中列出的UIView的UIConstraintBasedLayoutDebugging分类中的方法也可能有帮助。

解决方案 #

这是SwiftUI与UIKit键盘交互时的已知系统级问题，核心是模拟器中SecureField切换时，键盘辅助视图的布局约束出现冲突。可通过以下方式处理：

• 方案1：给输入框添加明确布局参数
  给输入框设置固定高度或内边距，帮助系统明确布局规则：

  VStack {
      TextField("邮箱", text: $email)
          .frame(height: 44)
          .padding(.horizontal)
      TextField("姓名", text: $name)
          .frame(height: 44)
          .padding(.horizontal)
      SecureField("密码", text: $password)
          .frame(height: 44)
          .padding(.horizontal)
  }
  

• 方案2：禁用键盘辅助视图
  自定义输入框组件，隐藏键盘顶部的辅助工具栏（含前进/后退按钮的栏）：

  import SwiftUI
  import UIKit
  
  struct NoAssistantTextField: UIViewRepresentable {
      @Binding var text: String
      var placeholder: String
      var isSecure: Bool = false
  
      func makeUIView(context: Context) -> UITextField {
          let textField = UITextField()
          textField.placeholder = placeholder
          textField.isSecureTextEntry = isSecure
          // 清空辅助栏按钮组
          textField.inputAssistantItem.leadingBarButtonGroups = []
          textField.inputAssistantItem.trailingBarButtonGroups = []
          return textField
      }
  
      func updateUIView(_ uiView: UITextField, context: Context) {
          uiView.text = text
      }
  }
  
  // 使用自定义组件
  struct RootView: View {
      @State var email: String = ""
      @State var name: String = ""
      @State var password: String = ""
  
      var body: some View {
          VStack {
              NoAssistantTextField(text: $email, placeholder: "邮箱")
                  .frame(height: 44)
                  .padding(.horizontal)
              NoAssistantTextField(text: $name, placeholder: "姓名")
                  .frame(height: 44)
                  .padding(.horizontal)
              NoAssistantTextField(text: $password, placeholder: "密码", isSecure: true)
                  .frame(height: 44)
                  .padding(.horizontal)
          }
      }
  }
  

• 方案3：忽略模拟器警告
  若该警告仅出现在模拟器，真机运行无异常，可暂时忽略——系统会自动打破冲突约束，不会影响功能正常使用。

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