Coil加载null URL时如何正确显示占位图？

架构老林

2026-8-20

解决Coil加载null URL时占位图不显示的问题

你的问题核心在于：当poster_path为null时，UtilsUi.BASE_URL + recyclerViewItem.poster_path会生成一个包含"null"字符串的无效URL（比如https://example.comnull），而非真正的null值。Coil的fallback仅在加载的数据源本身是null时才会触发，而无效URL加载失败时会走error，但可能因逻辑问题导致占位图没正常显示。以下是可行的解决方法：

方案1：提前判断路径有效性，分情况加载

直接检查poster_path是否为空，为空则直接加载占位图，否则加载拼接后的合法URL：

val posterPath = recyclerViewItem.poster_path
if (posterPath.isNullOrEmpty()) {
    binding.posterIv.load(R.drawable.placeholder_male)
} else {
    binding.posterIv.load(UtilsUi.BASE_URL + posterPath) {
        placeholder(R.drawable.placeholder_male)
        error(R.drawable.placeholder_male)
        fallback(R.drawable.placeholder_male)
    }
}

方案2：将无效路径转为null，触发fallback逻辑

把空路径的情况转为null数据源，让Coil的fallback规则生效：

val imageUrl = recyclerViewItem.poster_path?.takeIf { it.isNotEmpty() }?.let {
    UtilsUi.BASE_URL + it
}

binding.posterIv.load(imageUrl) {
    placeholder(R.drawable.placeholder_male)
    error(R.drawable.placeholder_male)
    fallback(R.drawable.placeholder_male)
}