You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native使用react-native-splash-screen库启动页图片不显示问题

React Native启动页图片不显示问题排查方案

我之前也碰到过一模一样的问题!结合你的描述和提供的布局代码,文本正常显示但图片在RN启动后消失,大概率是资源引用或构建缓存的问题,咱们一步步来解决:

  • 替换图片引用属性:把布局里的app:srcCompat="@drawable/splash"改成android:src="@drawable/splash"。srcCompat是AndroidX的兼容属性,在RN启动页的布局场景下偶尔会出现加载异常,换成原生的android:src通常能解决这个问题。修改后的ImageView代码:
<ImageView 
    android:layout_width="match_parent" 
    android:layout_height="200dp" 
    android:layout_gravity="center_horizontal" 
    android:src="@drawable/splash" />
  • 检查图片资源配置:确保你的splash.png存放在android/app/src/main/res/drawable(或对应分辨率的drawable-xxhdpi等子文件夹),文件名全小写、无特殊字符,避免RN打包过程中遗漏资源。

  • 清理缓存并重新构建:Android的构建缓存经常会导致资源不更新,执行以下命令彻底清理后重新运行:

cd android
./gradlew clean
cd ..
npx react-native run-android
  • 排查主题配置冲突:打开AndroidManifest.xml检查启动页Activity的主题设置,比如:
<activity
    android:name=".SplashActivity"
    android:theme="@style/SplashTheme">

如果SplashTheme里设置了android:windowBackground,可能会覆盖你布局里的背景和图片,建议把主题里的windowBackground移除,或者确保它和你的布局不冲突。

  • 调整图片缩放类型:给ImageView添加android:scaleType属性,比如android:scaleType="fitCenter",确保图片能适配ImageView的尺寸,避免因尺寸不匹配导致的“看似不显示”问题。

按照上面的步骤逐一排查,应该就能解决图片不显示的问题了!

内容的提问来源于stack exchange,提问作者Ray Coder

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.14 07:12:14