SwiftUI中UIImagePickerController搜索栏行为异常问题求助

问题描述 #

使用UIImagePickerController从用户相册选择图片时，其余功能均正常，但用户点击带放大镜图标的搜索栏时，有时会关闭ImagePicker，有时无响应，偶尔又能正常工作。

相关代码 #

弹窗触发代码

Button(action: {}) {
  ZStack {
    Image(systemName: "photo")
      .foregroundColor(darkMode ? .white : .black)
  }
}
.frame(width: 44, height: 44)
.onTapGesture {
  showPhotoLibrary.toggle()
}
.sheet(isPresented: $showPhotoLibrary) {
  ImagePicker(sourceType: .photoLibrary, selectedImage: self.$image)
}

ImagePicker实现代码

import SwiftUI

struct ImagePicker: UIViewControllerRepresentable {
  
  var sourceType: UIImagePickerController.SourceType = .photoLibrary
  @Binding var selectedImage: UIImage
  @Environment(\.presentationMode) private var presentationMode
  
  func makeUIViewController(context: UIViewControllerRepresentableContext<ImagePicker>) -> UIImagePickerController {
    
    let imagePicker = UIImagePickerController()

    imagePicker.sourceType = sourceType
    imagePicker.delegate = context.coordinator
    return imagePicker
  }
  
  func updateUIViewController(_ uiViewController: UIImagePickerController, context: UIViewControllerRepresentableContext<ImagePicker>) {
    
  }
  final class Coordinator: NSObject, UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    var parent: ImagePicker
    init(_ parent: ImagePicker) {
      self.parent = parent
    }
    
    internal func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
      if let image = info[UIImagePickerController.InfoKey.originalImage] as? UIImage {
        parent.selectedImage = image
      }
      parent.presentationMode.wrappedValue.dismiss()
    }
  }
  
  func makeCoordinator() -> Coordinator {
    Coordinator(self)
  }
}

解决思路 #

1. 补全代理方法，避免误触发关闭 #

当前Coordinator只实现了选图完成的代理方法，缺少取消选择的方法，同时UINavigationControllerDelegate的默认行为可能被干扰。补充以下方法到Coordinator中：

func imagePickerControllerDidCancel(_ picker: UIImagePickerController) {
    parent.presentationMode.wrappedValue.dismiss()
}

明确只有用户主动取消或选图完成时才关闭ImagePicker，避免系统默认的导航事件误触发dismiss。

2. 修复Sheet状态触发的冲突 #

原代码中Button同时使用了空的action和onTapGesture来切换状态，双重点击触发可能导致showPhotoLibrary状态异常，进而干扰Sheet的交互逻辑。修改Button代码如下：

Button(action: {
    showPhotoLibrary.toggle()
}) {
  ZStack {
    Image(systemName: "photo")
      .foregroundColor(darkMode ? .white : .black)
  }
}
.frame(width: 44, height: 44)
.sheet(isPresented: $showPhotoLibrary) {
  ImagePicker(sourceType: .photoLibrary, selectedImage: self.$image)
}

移除多余的onTapGesture，将状态切换逻辑统一放到Button的action中。

3. 调整ImagePicker的展示样式 #

iOS 13+的Sheet默认是半屏展示，拖拽关闭的交互可能和相册搜索栏的操作冲突。可以尝试将ImagePicker设置为全屏展示：
在makeUIViewController方法中添加：

imagePicker.modalPresentationStyle = .fullScreen

4. 排查系统版本与权限问题 #

• 部分iOS小版本存在UIImagePickerController搜索栏的已知bug，测试不同iOS版本确认是否为系统层面问题；
• 确保已正确申请并获取相册访问权限，权限不足可能导致相册界面交互异常。

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