Swift 6中EnvironmentKey并发问题及解决方案咨询

问题根源 #

Swift 6强化了并发安全规则，UIScreen.main现在被标记为Main Actor隔离属性，仅允许在Main Actor上下文访问。而EnvironmentKey协议要求其static var defaultValue必须是nonisolated（非隔离）的，直接在默认值计算逻辑中访问UIScreen.main会触发并发冲突错误。

一、Swift 6正确实现方案 #

由于SwiftUI视图的渲染逻辑始终运行在Main Actor上，我们可以通过MainActor.assumeIsolated安全地在defaultValue中访问Main Actor隔离属性，同时满足nonisolated的协议要求：

private struct SomeHeightKey: EnvironmentKey {
    // 缓存屏幕高度，避免重复获取
    @MainActor private static var cachedHeight: CGFloat?
    
    static var defaultValue: CGFloat {
        MainActor.assumeIsolated {
            cachedHeight ?? UIScreen.main.bounds.size.height
        }
    }
}

public extension EnvironmentValues {
    var someHeight: CGFloat {
        get { self[SomeHeightKey.self] }
        set { self[SomeHeightKey.self] = newValue }
    }
}

MainActor.assumeIsolated用于明确告知编译器：当前代码上下文确实处于Main Actor中（符合SwiftUI视图环境的运行规则），因此可以安全访问隔离属性。

二、临时兼容方案（快速迁移Swift 6） #

如果需要优先完成代码库迁移，后续再修复并发问题，可以采用以下临时方案绕过检查：

方案1：使用nonisolated(unsafe)临时绕过 #

private struct SomeHeightKey: EnvironmentKey {
    static var defaultValue: CGFloat {
        nonisolated(unsafe) {
            UIScreen.main.bounds.size.height
        }()
    }
}

public extension EnvironmentValues {
    var someHeight: CGFloat {
        get { self[SomeHeightKey.self] }
        set { self[SomeHeightKey.self] = newValue }
    }
}

注意：此方案不安全，仅用于临时过渡，后续必须替换为符合并发规范的实现。

方案2：简化默认值（如果实际不会被使用） #

观察你的ScrollViewWrapper代码，它会在视图层级中主动设置someHeight为GeometryReader的高度。如果所有使用someHeight的场景都处于ScrollViewWrapper的子视图中，默认值实际上不会被触发，此时可以直接设置一个占位默认值：

private struct SomeHeightKey: EnvironmentKey {
    static var defaultValue: CGFloat = 0 // 实际会被ScrollViewWrapper覆盖
}

public extension EnvironmentValues {
    var someHeight: CGFloat {
        get { self[SomeHeightKey.self] }
        set { self[SomeHeightKey.self] = newValue }
    }
}

三、替代实现思路（重构遗留代码） #

从ScrollViewWrapper的设计来看，它的核心意图是让ScrollView内容至少占满父视图高度，并将该高度传递给子视图。如果不需要通过环境传递高度，也可以直接将高度作为参数传递给子视图，彻底规避EnvironmentKey的并发问题：

public struct ScrollViewWrapper<Content: View>: View {
    let content: (CGFloat) -> Content

    public init(@ViewBuilder _ content: @escaping (CGFloat) -> Content) {
        self.content = content
    }

    public var body: some View {
        GeometryReader { proxy in
            ScrollView {
                content(proxy.size.height)
                    .frame(minHeight: proxy.size.height)
            }
            .frame(height: proxy.size.height)
        }
    }
}

使用时直接传入高度：

ScrollViewWrapper { height in
    YourSubView()
        .someModifier(using: height)
}

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