从PWABuilder下载的Swift文件编译报错：WKWebView无underPageBackgroundColor成员

1. 检查iOS部署目标版本 #

打开Xcode，选中项目根目录，切换到「Info」标签页，找到「Deployment Target」选项，确认其值为iOS 15.0或更高版本。如果部署目标低于iOS 15.0，即使代码里有版本判断，编译器仍会因为不支持该API而报错。

2. 确认Xcode版本 #

WKWebView.underPageBackgroundColor是iOS 15.0新增的API，需要Xcode 13或更高版本才能识别。如果你的Xcode版本过低，直接更新到最新稳定版即可。

3. 验证WKWebView的类型 #

按住Command键点击代码中的WKWebView，查看跳转后的类定义是否来自系统的WebKit框架。如果是自定义类或第三方库重命名的WKWebView，可能没有这个属性。这种情况下，需要确认PWABuilder生成的代码是否引用了正确的系统WKWebView。

4. 尝试修复或替换代码 #

如果以上步骤都没问题，可能是PWABuilder的模板存在bug：

• 先尝试重新通过PWABuilder生成项目，选择最新的模板版本；
• 若仍报错，可手动修改代码：
  • 如果不需要自适应主题功能，直接注释掉这段版本判断内的代码；
  • 如果需要保留主题适配，可将underPageBackgroundColor替换为backgroundColor（注意：两者逻辑有差异，backgroundColor是WebView自身的背景色，而非网页底层背景色，需测试效果）。

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