带图片的UIBarButtonItem覆盖UINavigationBar标题问题求助

先还原你的问题场景：

当我尝试添加一个带图片的右侧UIBarButtonItem时（无论是通过代码还是Storyboard），它最终会居中并覆盖导航栏标题（见下方图片）。请问这是什么原因？

正常状态的导航栏：

异常状态（按钮覆盖标题）：

这种问题我在项目里碰到过好几次，主要是下面几个常见原因，你可以逐一排查：

• 图片尺寸超出导航栏范围：导航栏默认高度是44pt（大尺寸设备或横屏时为48pt），如果按钮图片尺寸远大于这个值，系统会自动调整按钮布局位置，导致它偏移到中间。解决办法是先把图片缩放到合适大小，或者通过代码调整图片的内边距和渲染模式：

  // Swift示例代码
  guard let buttonImage = UIImage(named: "your-image-name")?.withRenderingMode(.alwaysOriginal) else { return }
  let rightButton = UIBarButtonItem(image: buttonImage, style: .plain, target: self, action: #selector(rightButtonTapped))
  // 调整内边距，让按钮回到右侧正确位置
  rightButton.imageInsets = UIEdgeInsets(top: 2, left: 0, bottom: 2, right: -8)
  navigationItem.rightBarButtonItem = rightButton
  

• 导航栏内部布局约束冲突：有时候项目里的自定义代码或第三方库会意外修改导航栏的默认约束，导致按钮布局逻辑混乱。你可以尝试重置导航栏布局，或者用Xcode的「Debug View Hierarchy」工具查看导航栏约束情况，找出冲突项并修复。

• 自定义导航栏布局逻辑错误：如果你使用了自定义UINavigationBar子类，重写layoutSubviews方法时一定要记得调用super.layoutSubviews()，否则会破坏系统默认布局逻辑，导致按钮位置错乱。

• 标题视图设置异常：如果导航栏标题是通过titleView自定义的，而非直接设置navigationItem.title，可能会因为自定义视图布局问题，导致系统重新分配按钮位置。检查是否有代码错误地将titleView设为空或布局异常。

如果以上方法都无效，你可以新建一个空白测试项目，只添加导航栏和右侧按钮，看看是否能正常显示——这样能快速排查是不是项目里的其他代码干扰了导航栏布局。

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