升级Xcode 15.0 beta4后iOS应用因私有PasswordManagerUI.framework启动崩溃

问题复现 #

升级至Xcode 15.0 Beta 4后，iOS应用启动即崩溃，报错如下：

dyld[79107]: Symbol not found: _$s7SwiftUI4ViewP8SettingsE22settingsListAppearanceQryF
  Referenced from: <071C5D97-C707-3413-B467-43E260234D2B> /Library/Developer/CoreSimulator/Volumes/iOS_21A5277g/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS 17.0.simruntime/Contents/Resources/RuntimeRoot/System/Cryptexes/OS/System/Library/PrivateFrameworks/PasswordManagerUI.framework/PasswordManagerUI
  Expected in:     <81D8282A-1DBD-3D15-B833-495D945BE8CA> /Users/****/Build/Products/Debug-iphonesimulator/Settings.framework/Settings

问题原因 #

自定义的Settings.framework与系统私有框架PasswordManagerUI存在符号命名冲突：系统的PasswordManagerUI框架会尝试查找名为settingsListAppearance的SwiftUI View扩展符号，而该符号被系统解析到了你的自定义Settings.framework中，但你的框架并没有实现这个符号，最终导致dyld加载失败。这种冲突由密码自动填充功能触发——只要应用配置了支持密码自动填充（如Info.plist相关配置、共享密码能力），系统就会自动加载PasswordManagerUI，进而触发符号查找错误。

解决方案 #

方案1：修改自定义框架的模块名（推荐） #

直接避免模块名冲突是最彻底的解决方式：

• 打开自定义Settings.framework的项目，进入Build Settings
• 找到Product Module Name，将其修改为非Settings的名称（比如AppSettings、MyAppSettings）
• 重新编译框架，在主项目中替换原有框架引用，并将所有代码中的import Settings替换为新的模块名（如import AppSettings）

方案2：隐藏冲突符号 #

如果无法修改模块名，可以通过链接配置阻止自定义框架导出冲突符号：

• 在自定义框架的Build Settings中找到Other Linker Flags
• 添加如下参数：

  -Wl,-U,_$s7SwiftUI4ViewP8SettingsE22settingsListAppearanceQryF
  

  该参数会将指定符号标记为未导出，避免系统dyld将其识别为期望的符号来源。若有多个冲突符号，可依次添加多个-Wl,-U,_<符号名>参数。

方案3：临时调试绕过（仅用于测试） #

如果需要临时跳过崩溃进行调试，可以暂时关闭密码自动填充功能：

• 打开应用的Info.plist
• 添加或修改NSPasswordAutofillEnabled为NO
• 移除与密码自动填充相关的其他配置（如ASCredentialProviderViewController的相关注册代码）

  注意：这只是临时方案，发布前必须恢复密码自动填充配置并采用方案1或2解决根本问题

补充说明 #

移除框架内的密码字段引用无效，是因为密码自动填充的触发逻辑在系统层面——只要应用具备相关配置，系统就会加载PasswordManagerUI框架，与代码中是否直接使用密码字段无关。

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