## Android界面设计里这类问题怎么出现

Compose 列表页：预览偏差这次按新的切面重写，先锁新问题边界，再展开排查与修复。

如果日志、监控、数据库状态各说各话，Compose 列表页：预览偏差 的定位就会被拉长，所以开场先把触发条件、影响范围和错误信号钉死最重要。很多团队以为自己缺的是更多代码，实际更缺的是把 Compose 列表页 这条链路拆成可观察节点，否则每次都像在盲调。Compose 列表页 这次改用新的故障入口来拆，不再复用旧文套路。

## Compose 列表页解决方案

我会先补 把 UI state 和 effect 分层，再收紧 为 item key 建稳定主键，最后把 把昂贵计算迁到 remember 或 ViewModel 补齐。这个顺序的好处是改动小、回归快、证据也更容易收口。方案上不要急着推翻整条链路，先把最危险的节点单点替换掉，再用 Layout Inspector 和 Compose Tracing 把新旧行为对齐。只要状态生产者、状态消费者、兜底重试这三层没有明确 owner，Compose 列表页 后面一定还会反复炸，所以这里先把责任边界钉住。

## 直接可抄片段

如果一段代码不能直接进工程跑，一条命令不能直接拿去比对现场，那它对排障文章的价值就不够高。下面这组片段按新的代码入口与验证顺序展开。

1. 关键实现

@Composable
fun ArticleListScreen(state: ArticleListState, onRefresh: () -> Unit) {
    SwipeRefresh(state = rememberSwipeRefreshState(state.refreshing), onRefresh = onRefresh) {
        LazyColumn {
            items(items = state.items, key = { it.id }) { item ->
                ArticleRow(item = item)
            }
        }
    }
}

2. 先跑这些命令

adb shell am profile start com.example.app /sdcard/compose.trace
adb pull /sdcard/compose.trace ./compose.trace

3. 修复辅助代码

data class JiemianshejiCheckResult(
    val key: String,
    val ok: Boolean,
    val detail: String
)

fun verifyJiemianshejiState(key: String, expected: String, actual: String): JiemianshejiCheckResult {
    val ok = expected == actual
    return JiemianshejiCheckResult(key, ok, if (ok) "matched" else "$expected != $actual")
}

## Compose 列表页注意点

如果这篇文章是给团队复用的，最值钱的不是大道理，而是‘出现什么信号就别继续查 A，直接切去查 B’这种分叉提示。如果旧文已经把 Compose 列表页 讲成通用排查文章，这次就别再重复宽口径写法，直接缩到更具体的子问题与验证信号。先盯三类高危点：状态提升不彻底导致重组频繁；预览和真机表现偏差太大；滚动列表里图片加载抖动。多数时候不是接口挂了，而是边界松了。

## Compose 列表页常见异常

1. 状态不一致

如果现场出现旧数据覆盖新数据、页面恢复后状态倒退，先用 Layout Inspector 对齐时间线，再核对本地状态迁移是不是原子提交。把请求发出、回包落库、UI 消费三段时间顺序排清楚，根因通常会自己浮出来。

adb shell am profile start com.example.app /sdcard/compose.trace
adb pull /sdcard/compose.trace ./compose.trace

2. 多入口重复跑

如果后台恢复、重试或多入口并发后任务跑了两次，优先补幂等键、唯一调度名和入口锁，再回头核对 为 item key 建稳定主键 有没有被真正收紧。别只看业务日志，还要确认调度层是不是只进了一次。

fun jiemianshejiWorkName(id: String): String {
    return "jiemiansheji-$id"
}

fun shouldSkipJiemiansheji(running: Boolean, hasPending: Boolean): Boolean {
    return running || hasPending
}

## Compose 列表页最小可运行示例

这段最适合直接扔进 demo、测试工程或排障脚本库里，后面团队再回头看 Android界面设计 的问题时能直接复用。真正有价值的最小样例，必须保留最短入口、最少依赖和明确输出，这样复现、修复、回归三步才能连起来。只要先稳定复现一次，再把修复版稳定跑通一次，文章就不是经验笔记，而是可执行模板。

1. 先定义状态对象

data class JiemianshejiState(
    val id: String,
    val status: String,
    val updatedAt: Long,
    val source: String
)

2. 启动验证入口

fun runJiemianshejiDemo() {
    val state = JiemianshejiState("42", "pending", System.currentTimeMillis(), "jiemiansheji")
    println(state)
}

3. 本地验证命令

adb shell am profile start com.example.app /sdcard/compose.trace
adb pull /sdcard/compose.trace ./compose.trace
adb logcat -d | findstr /I "Exception timeout retry"