React Native Android自定义图片Marker：Release模式不显示求助

我之前踩过完全一样的坑！Debug模式下一切正常，一打包Release就看不到自定义Marker的图片，多半是资源打包、混淆或者引用方式的问题，给你整理几个实测有效的解决办法：

1. 修正本地图片的引用方式 #

如果你的Marker用的是本地图片，不要直接用require('./custom-marker.png')——在Release模式下React Native的资源路径会被优化，地图SDK可能无法正确解析。正确的做法是：

• 将图片放到android/app/src/main/res/drawable（或对应密度的文件夹，比如drawable-hdpi）下，命名用小写字母+下划线（比如custom_marker.png，避免特殊字符和空格）
• 在Marker的icon属性里用uri: 'drawable://custom_marker'来引用：

  <Marker
    coordinate={coords}
    icon={{ uri: 'drawable://custom_marker' }}
  />
  

2. 配置ProGuard规则防止资源被移除 #

Release打包时ProGuard会优化代码和资源，很可能把地图相关的资源或类给移除了。打开android/app/proguard-rules.pro，添加以下规则：

# 保留React Native图片相关类
-keep class com.facebook.react.views.image.** { *; }
# 保留谷歌地图SDK相关类
-keep class com.google.android.gms.maps.model.** { *; }
# 保留所有drawable资源
-keepresources drawable/**

如果你用的是高德、百度等第三方地图SDK，还要加上对应SDK的ProGuard规则，比如高德的：

-keep class com.amap.api.maps.** { *; }
-keep class com.autonavi.amap.mapcore.** { *; }

3. 检查图片格式和打包配置 #

• 确保图片是Android支持的格式（PNG、JPG优先），如果用WebP格式，需要在android/app/build.gradle里开启WebP支持：

  android {
    buildFeatures {
      webp true
    }
  }
  

• 不要把图片放在assets文件夹下，地图SDK在Release模式下读取assets资源的兼容性不如drawable文件夹。

4. 彻底清理缓存重新打包 #

有时候旧的构建缓存会导致资源加载异常，执行以下命令彻底清理后重新打包：

# 清理Android构建缓存
cd android && ./gradlew clean
# 返回根目录打包Release版本
cd .. && npx react-native run-android --mode release

5. 第三方地图SDK额外检查 #

如果你用的是高德、百度等第三方地图：

• 确认AndroidManifest里的API Key是Release环境的（Debug和Release的Key通常不同，因为签名不一样）
• 检查Release包的签名是否和申请Key时用的签名一致，签名不匹配会导致SDK功能异常
• 确保已经添加必要的权限，比如读取本地资源的权限：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

按照这个顺序排查，基本能解决90%以上的问题。

内容的提问来源于stack exchange，提问作者حسن علاونة