iOS15下SwiftUI的contentMode: .fill不生效 Xcode13开发问题求助

问题根因 #

该问题是Xcode 13编译后，SwiftUI在iOS 15上的API行为隐性变更导致，不属于代码逻辑错误：

• 旧版本iOS中，aspectRatio(_:contentMode:) 第一个参数传入nil时，系统会自动沿用图片本身的宽高比执行对应缩放逻辑；iOS 15对该API的参数校验逻辑收紧，显式传nil时会直接丢弃图片宽高比约束，导致fill模式无法按照原图比例拉伸填充。
• iOS 15对NavigationView嵌套后的父容器尺寸计算逻辑有调整，background视图会默认被约束到VStack的内容尺寸，而不是自动撑满整个屏幕，进一步加剧了显示异常。

该问题属于SwiftUI跨版本行为兼容问题，是API使用的隐性变更未在官方 Release Note中明确标注导致，不属于功能性系统Bug。

修复方案 #

方案1：使用scaledToFill简化写法（最推荐） #

直接替换掉传nil的aspectRatio写法即可，该API会自动沿用图片宽高比执行填充逻辑，兼容所有iOS版本：

.background(
    Image(R.image.bg_home_big.name)
        .resizable()
        .scaledToFill()
        .ignoresSafeArea()
)

方案2：显式指定图片宽高比 #

如果需要保留aspectRatio写法，把第一个参数的nil替换为原图的实际宽高比值即可：

.background(
    Image(R.image.bg_home_big.name)
        .resizable()
        .aspectRatio(1080/1920.0, contentMode: .fill) // 示例值，替换为你的原图宽高比
        .ignoresSafeArea()
)

补充适配 #

如果修复后还是出现图片没有撑满屏幕的情况，给图片增加最大宽高约束强制撑满父容器：

.background(
    Image(R.image.bg_home_big.name)
        .resizable()
        .scaledToFill()
        .frame(maxWidth: .infinity, maxHeight: .infinity)
        .ignoresSafeArea()
)

内容的提问来源于stack exchange，提问作者Sebastián García Burgos