iOS开发添加UIScrollView后出现黑屏，求问题原因排查

你的代码里有几个关键问题导致黑屏，逐一说明：

• contentView缺少顶部约束
  UIScrollView的contentView必须明确上下左右的约束，否则scrollView无法正确计算内容区域的大小和位置。你当前只给contentView设置了leading、trailing、bottom和width约束，缺少topAnchor与scrollView的关联，导致contentView的位置无法确定，可能被挤出可视范围，而scrollView默认背景色为黑色，所以呈现黑屏。

• mealImageView高度约束依赖未初始化的frame
  在viewDidLoad阶段，contentView的frame还未完成布局计算，contentView.frame.size.height的值为0，这会导致mealImageView的高度被设为0，最终没有内容显示，进一步加剧黑屏问题。

• 未定义的recipeLabel
  代码中直接添加recipeLabel到contentView，但这个控件从未声明和初始化，会导致运行时错误，也可能影响整体布局稳定性。

修复后的代码片段 #

修复setupScrollView方法（补充contentView顶部约束）

private func setupScrollView() {
    let padding: CGFloat = 20
    scrollView.translatesAutoresizingMaskIntoConstraints = false
    contentView.translatesAutoresizingMaskIntoConstraints = false
    contentView.backgroundColor = .white
    view.addSubview(scrollView)
    scrollView.addSubview(contentView)

    NSLayoutConstraint.activate([
        scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        scrollView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        scrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor),

        // 补充contentView顶部约束，关联到scrollView的topAnchor
        contentView.topAnchor.constraint(equalTo: scrollView.topAnchor, constant: padding),
        contentView.leadingAnchor.constraint(equalTo: scrollView.leadingAnchor, constant: padding),
        contentView.trailingAnchor.constraint(equalTo: scrollView.trailingAnchor, constant: -padding),
        contentView.bottomAnchor.constraint(equalTo: scrollView.bottomAnchor, constant: -padding),
        contentView.widthAnchor.constraint(equalTo: scrollView.widthAnchor, constant: -padding * 2)
    ])
}

修复setupSubviews方法（调整imageView高度约束，添加recipeLabel定义）

// 先补充recipeLabel的定义
private let recipeLabel: UILabel = {
    let label = UILabel()
    label.translatesAutoresizingMaskIntoConstraints = false
    label.numberOfLines = 0
    return label
}()

private func setupSubviews() {
    contentView.backgroundColor = .white
    contentView.addSubview(mealImageView)
    contentView.addSubview(recipeLabel)

    NSLayoutConstraint.activate([
        // mealImageView的top约束改为关联contentView的topAnchor，而非safeAreaLayoutGuide（contentView不是控制器视图，safeArea无效）
        mealImageView.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 10),
        mealImageView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 10),
        mealImageView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -10),
        // 改用固定高度或者基于屏幕高度的约束，避免依赖未初始化的frame
        mealImageView.heightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.heightAnchor, multiplier: 1/3),
        
        // 给recipeLabel添加约束，确保contentView能计算出正确的bottom位置
        recipeLabel.topAnchor.constraint(equalTo: mealImageView.bottomAnchor, constant: 20),
        recipeLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 10),
        recipeLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -10),
        recipeLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -20)
    ])
}

额外说明：

• 控制器的view默认背景色如果是黑色，也可能导致视觉上的黑屏，但你的代码里contentView设为白色，主要问题还是布局约束缺失和错误。
• 确保meal对象正确传递，mealImageView的图片能正常加载（如果图片加载失败，imageView会显示灰色背景，但不会导致整个屏幕黑屏）。

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