CapacitorJS iOS项目启动报错：@capacitor/splash-screen 解析失败

问题场景 #

新建CapacitorJS项目后，仅执行以下命令添加并同步iOS平台：

npx cap add ios
npx cap sync
npx cap open ios

Web版本运行完全正常，但在Xcode中启动项目后出现白屏，控制台输出错误：

⚡️ ------ STARTUP JS ERROR ------

⚡️ TypeError: Module name, '@capacitor/splash-screen' does not resolve to a valid URL.
⚡️ URL:
⚡️ [error] - {}
⚡️ :0:0

⚡️ See above for help with debugging blank-screen issues

移除代码中所有插件引用后，应用可以正常显示内容，但这并非可行解决方案，最终切换到Next.js框架。

可能的解决方案 #

• 确认插件安装完整性：执行npm install @capacitor/splash-screen确保插件依赖已正确安装，随后重新运行npx cap sync将插件同步到iOS项目中。
• 检查Capacitor配置：打开capacitor.config.ts（或.js）文件，确认SplashScreen插件的配置项拼写正确，没有语法错误。
• 清理iOS项目缓存：在Xcode中使用Cmd+Shift+K清理项目，手动删除DerivedData目录（路径：~/Library/Developer/Xcode/DerivedData），之后重新构建项目。
• 验证构建工具配置：如果项目使用Vite、Webpack等构建工具，确保配置文件中正确处理了@capacitor/*前缀的模块解析，避免构建时遗漏插件资源。
• 对齐Capacitor版本：检查package.json中@capacitor/core和@capacitor/splash-screen的版本号是否一致，版本不匹配可能导致模块解析异常。

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