title: Wi-Fi 评分、网络选择与连接切换性能 chapter: '24.8' section: '24.8' status: finalized applicable_versions: Android 10 (API 29) - Android 17 (API 37) last_verified: '2026-08-15' last_verified_against: AOSP android-17.0.0_r1 (Wifi, Connectivity and NetworkStack); Android Developers connectivity and Cronet docs current through 2026-08-15; OkHttp 5.4.0 source and changelog confidence: high sources:

• type: aosp path: packages/modules/Wifi/service/java/com/android/server/wifi/WifiNetworkSelector.java
• type: aosp path: packages/modules/Wifi/service/java/com/android/server/wifi/WifiCandidates.java
• type: aosp path: packages/modules/Wifi/framework/java/android/net/wifi/WifiManager.java
• type: aosp path: packages/modules/Connectivity/service/src/com/android/server/connectivity/NetworkRanker.java
• type: aosp path: packages/modules/Connectivity/service/src/com/android/server/connectivity/FullScore.java
• type: aosp path: packages/modules/NetworkStack/src/com/android/server/connectivity/NetworkMonitor.java
• type: official path: https://source.android.com/docs/core/connect/wifi-network-selection
• type: official path: https://source.android.com/docs/core/connect/network-selection
• type: official path: https://developer.android.com/develop/connectivity/network-ops/reading-network-state
• type: official path: https://developer.android.com/reference/android/net/NetworkCapabilities
• type: official path: https://developer.android.com/reference/android/net/ConnectivityManager
• type: official path: https://developer.android.com/reference/android/net/ConnectivityManager.NetworkCallback
• type: official path: https://developer.android.com/reference/android/net/Network
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Wifi/+/refs/tags/android-17.0.0_r1/service/java/com/android/server/wifi/WifiNetworkSelector.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Wifi/+/refs/tags/android-17.0.0_r1/service/java/com/android/server/wifi/ThroughputScorer.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Connectivity/+/refs/tags/android-17.0.0_r1/framework/src/android/net/ConnectivityManager.java
• type: aosp path: https://android.googlesource.com/platform/packages/modules/Connectivity/+/refs/tags/android-17.0.0_r1/service/src/com/android/server/connectivity/NetworkRanker.java
• type: upstream path: https://github.com/lysine-dev/okhttp/blob/parent-5.4.0/okhttp/src/commonJvmAndroid/kotlin/okhttp3/EventListener.kt
• type: upstream path: https://github.com/lysine-dev/okhttp/blob/main/CHANGELOG.md
• type: blog path: DeepResearch/2026-05-14-android-wifi-scoring-connectivity-service.md
• type: book_structure path: Clippings/Android 性能优化 - 原理:重新认识应用的速度优化.md
• type: book_structure path: Clippings/Android 性能优化 - CPU 优化(下):减少 CPU 闲置时刻和等待,提升利用率.md
• type: book_structure path: Clippings/Android 性能优化 - 缓存优化:冷热端分离+重排序,提升缓存命中率.md
• type: book_structure path: Clippings/线上疑难问题该如何排查和跟踪?-Android开发高手课-极客时间 18.md
• type: book_structure path: Clippings/线上疑难问题该如何排查和跟踪?-Android开发高手课-极客时间 19.md
• type: book_structure path: Clippings/线上疑难问题该如何排查和跟踪?-Android开发高手课-极客时间 20.md tags:
• wifi
• connectivity
• network
• latency
• scoring
• performance related_chapters:
• '12.1'
• '24.5'
• '24.6'
• '16.3' task6_state: reviewed task9_state: reviewed task2b_state: fixed pipeline_stage: finalized last_review_finalize_at: '2026-08-15T11:11:04+08:00' last_review_finalize_run_id: 20260815-111104-gracker-writing-review last_draft_polish_at: '2026-08-15T11:11:04+08:00' last_draft_polish_run_id: 20260815-111104-gracker-writing

Wi-Fi 评分、网络选择与连接切换性能

平台源码锚点是 Android 17（API 37）/ android-17.0.0_r1。应用看到默认网络可用之前，系统至少完成两类决策：Wi-Fi 模块在可连接的 AP（access point，无线接入点）中选择网络，Connectivity 模块在 Wi-Fi、蜂窝、以太网、VPN 等并存网络中，为应用或系统提出的网络请求选择满足条件的网络。两类决策使用不同输入，不能合并成一个“网络分数”。

Wi-Fi 图标、RSSI（received signal strength indicator，接收信号强度）、NET_CAPABILITY_VALIDATED 和业务接口成功，分别描述无线关联、无线信号、系统探测到公网可达，以及目标服务可用。四者可能给出不同结果。排查连接切换时，要分别记录系统选择事件、HTTP 请求过程和业务恢复时刻。连接池、TLS 与 HTTP 协议细节见 12.1 网络请求、24.5 移动网络架构、连接生命周期与容灾策略 和 24.6 HTTP/2、HTTP/3、gRPC 与 ECH。

系统怎样选出默认网络

ConnectivityService 与 Wi-Fi 模块各管一层

这条路径只描述主要控制关系，不代表每次扫描都会触发重选或重新关联。BSSID（basic service set identifier）标识一个基本服务集，通常对应 AP 的一个无线电接口；NetworkAgent 是各网络模块向 Connectivity 报告网络及其能力的系统对象：

Wi-Fi 扫描结果
  → WifiNetworkSelector 判断当前连接是否足够好
  → 过滤不合格的非当前 BSSID
  → NetworkNominator 生成候选网络
  → ThroughputScorer 对候选网络和 BSSID 评分
  → WifiNetworkAgent 把已连接网络作为 NetworkAgent 上报
  → ConnectivityService 为 NetworkRequest 筛出满足能力的 NetworkAgent
  → NetworkRanker 按策略选择当前满足者
  → App 通过 ConnectivityManager 观察默认网络变化

Wi-Fi 模块主要回答“连接哪个 Wi-Fi 网络或 BSSID”。Connectivity 模块回答“哪个 Network 满足某个 NetworkRequest”。Network 是 Android 对一条可用网络路径的句柄，NetworkRequest 是传输类型与网络能力等条件的集合。默认网络只是系统请求中的一类；VPN 还可能让不同 UID（user identifier，Android 用来区分应用身份的整数）看到不同的应用默认网络。

Android 17 的 WifiNetworkSelector.filterScanResults() 会排除低于入网 RSSI 阈值、命中 BSSID 阻止列表、被 MBO/OCE 拒绝关联、不满足设备管理策略或使用已弃用安全类型的结果。MBO（Multi Band Operation）与 OCE（Optimized Connectivity Experience）是 Wi-Fi 联盟定义的接入管理和连接优化能力。已连接的当前 BSSID 会在这些普通过滤条件之前保留；当前 BSSID 未出现在一次扫描中时，源码还可能放弃本轮选择，避免不完整的扫描结果触发不必要的切换。

getCandidatesFromScan() 调用已注册的 nominator（候选提名器），产生已保存网络、由应用通过 WifiNetworkSuggestion 提交的 Suggestion 网络等候选，并把当前连接留在候选集合中。selectNetwork() 再交给活动的 CandidateScorer（候选评分器）选出结果，并应用兼容旧版用户选择的逻辑。Android 17 的预设评分器是 ThroughputScorer。

Connectivity 先保留能满足请求能力的网络，再执行 NetworkRanker.getBestNetworkByPolicy()。Android 17 的主要规则按源码顺序如下：

这张表描述逐轮筛选，不是一条把所有属性相加的公式。Connectivity 把验证状态、VPN 和销毁状态等运行时信息整理成 FullScore；网络模块用 NetworkScore 携带 POLICY_TRANSPORT_PRIMARY、POLICY_EXITING 等策略属性。Android 17 的通用排序代码没有实现“所有网络一律未计费优先”，对应位置仍有表示“待实现”的 TODO 注释。NET_CAPABILITY_NOT_METERED 能决定带有该能力要求的请求是否得到满足，Wi-Fi 候选评分也会奖励未计费网络，但这两点不能外推成所有默认网络共用的排序公式。

Android 10 到 Android 17 经历了两套 Connectivity 选择机制：

Wi-Fi RSSI 下降后，应用不一定马上收到默认网络变化。当前 Wi-Fi 仍可能被判定为足够好；连接新候选并验证公网可达也需要时间；策略结果相同时，NetworkRanker 还会保留正在满足请求的网络。

Wi-Fi 评分使用哪些输入

当前连接是否需要重选

Android 17 的 WifiNetworkSelector.isNetworkSufficient() 依次检查连接状态、用户近期选择、OSU、外部评分器给出的可用性、连接分数、OEM 标记、计费属性、历史无互联网状态、IP 配置以及无线质量。OSU（Online Sign-Up）是 Hotspot 2.0 的在线注册流程；OEM paid/private 表示设备厂商或运营商标记的付费网络、专用网络。只有 RSSI 不足且收发流量也不活跃时，无线质量这一项才判为不足。

这段逻辑使用 Wi-Fi 子系统内部状态和可被设备配置覆盖的资源值，普通应用不能只用 RSSI 复现。官方《Wi-Fi 网络选择》页面主要描述 Android 12 行为，并提示后续版本应以对应版本的 AOSP 源码为准。

候选如何评分

Android 17 的 WifiCandidates.Candidate 和 ThroughputScorer 可确认以下输入：

ScoringParams 和资源覆盖（设备厂商对 AOSP 默认资源值的替换）控制入网阈值、足够 RSSI、吞吐奖励和多个优先级参数。旧资料中的固定阈值只能说明特定版本的 AOSP 默认配置，不能作为跨版本、跨厂商的发布条件。

怎样度量连接切换

普通应用看不到 NetworkRanker 开始决策的时刻，因此不能从公开回调直接计算“系统选网耗时”。可以稳定观测的是默认网络通知、能力变化、HTTP 事件和业务恢复：

onLost(old) 不能作为默认网络切换起点。对默认网络回调（default callback）而言，onAvailable(new) 表示回调已经开始跟踪新的最佳网络，之后不会再接收旧网络的事件。只有正在跟踪的默认网络丢失且没有替代网络时，onLost() 才表示应用失去默认网络。

OkHttp 的事件序列不能压成“每种事件只留一个时间戳”。重试、重定向和认证会在同一个 Call 中产生多组 DNS、连接、请求和响应事件；复用既有连接时没有 DNS 与 connect 事件；双工请求的收发事件还可能交错。

这段监听器按 OkHttp 5.4.0 的接口签名编写，并保留原始单调时钟时间线。单调时钟只随设备运行时间前进，不受用户改时间或系统校时影响。defaultGeneration 是本文为每次默认网络变化分配的递增序号，只用于关联一次切网期间的事件：

data class CallMark(
    val name: String,
    val elapsedNanos: Long,
)

data class CallTimeline(
    val callId: Long,
    val defaultGenerationAtStart: Long?,
    val terminal: String,
    val marks: List<CallMark>,
)

class TimelineEventListener(
    private val callId: Long,
    private val defaultGeneration: () -> Long?,
    private val report: (CallTimeline) -> Unit,
) : EventListener() {
    private val marks = mutableListOf<CallMark>()
    private var generationAtStart: Long? = null
    private var reported = false

    @Synchronized
    private fun mark(name: String) {
        marks += CallMark(name, SystemClock.elapsedRealtimeNanos())
    }

    override fun callStart(call: Call) {
        generationAtStart = defaultGeneration()
        mark("callStart")
    }

    override fun dispatcherQueueStart(call: Call, dispatcher: Dispatcher) =
        mark("dispatcherQueueStart")

    override fun dispatcherQueueEnd(call: Call, dispatcher: Dispatcher) =
        mark("dispatcherQueueEnd")

    override fun dnsStart(call: Call, domainName: String) {
        mark("dnsStart")
    }

    override fun dnsEnd(call: Call, domainName: String, inetAddressList: List<InetAddress>) {
        mark("dnsEnd")
    }

    override fun connectStart(call: Call, inetSocketAddress: InetSocketAddress, proxy: Proxy) {
        mark("connectStart")
    }

    override fun secureConnectStart(call: Call) {
        mark("secureConnectStart")
    }

    override fun secureConnectEnd(call: Call, handshake: Handshake?) {
        mark("secureConnectEnd")
    }

    override fun connectEnd(
        call: Call,
        inetSocketAddress: InetSocketAddress,
        proxy: Proxy,
        protocol: Protocol?,
    ) {
        mark("connectEnd")
    }

    override fun connectionAcquired(call: Call, connection: Connection) {
        mark("connectionAcquired")
    }

    override fun requestHeadersEnd(call: Call, request: Request) {
        mark("requestHeadersEnd")
    }

    override fun requestBodyEnd(call: Call, byteCount: Long) {
        mark("requestBodyEnd")
    }

    override fun responseHeadersStart(call: Call) {
        mark("responseHeadersStart")
    }

    override fun responseBodyEnd(call: Call, byteCount: Long) {
        mark("responseBodyEnd")
    }

    override fun callEnd(call: Call) {
        finish("callEnd")
    }

    override fun callFailed(call: Call, ioe: IOException) {
        finish("callFailed:${ioe.javaClass.name}")
    }

    private fun finish(terminal: String) {
        val timeline = synchronized(this) {
            if (reported) return
            marks += CallMark(terminal, SystemClock.elapsedRealtimeNanos())
            reported = true
            CallTimeline(
                callId = callId,
                defaultGenerationAtStart = generationAtStart,
                terminal = terminal,
                marks = marks.toList(),
            )
        }
        report(timeline)
    }
}

截至 2026-08-15，OkHttp 最新稳定版本为 5.4.0。示例使用该版本的 dispatcherQueueStart(call, dispatcher) 和 dispatcherQueueEnd(call, dispatcher) 签名；升级依赖后仍应以对应版本的 EventListener 源码为准。

监听器应由 EventListener.Factory 为每个 Call 单独创建。一次 Call 可能因重试或重定向包含多次 HTTP 交换，也就是多轮请求与响应；分析端要按完整事件序列分组，不能把末次 dnsEnd 与第一次 dnsStart 相减。defaultGenerationAtStart 也不能证明连接使用了该网络：复用连接可能建立在更早的默认网络上，显式绑定的客户端还可能使用其他 Network。若要确认套接字经过哪条网络，还要结合绑定配置、系统追踪数据或网络数据包捕获结果。

弱网与多网络并存时怎样判断

能力字段只提供分层证据：

这张表的用途是限定结论：能力字段描述系统掌握的网络属性，不能替代一次真实业务请求。

Android 17 的 NetworkMonitor 会在目标 Network 上执行 DNS 与 HTTP/HTTPS 探测，并根据成功、登录门户、部分连通等结果更新 Connectivity。探测 URL、代理、Private DNS（Android 对 DNS-over-TLS 的系统配置）与设备配置都可能影响结果。因此：

• 没有应用默认网络时，普通默认绑定请求无法新建连接；显式请求的其他网络要单独判断。
• 有 INTERNET 但没有 VALIDATED 时，可展示离线数据并降低后台重试，不应把所有用户操作永久禁用。
• 有 CAPTIVE_PORTAL 时，可引导用户完成系统登录流程。
• 已有 VALIDATED 时，业务请求仍需处理 DNS、路由、TLS、服务端和账号错误。
• VPN 的传输集合会随承载网络改变；诊断时同时记录 VPN、Wi-Fi 与蜂窝标记。

网络能力会动态变化，单次 activeNetwork 查询只代表查询当时的状态。持续观测应依靠回调。

应用侧能做什么

普通应用不能读取或控制系统 Wi-Fi 最终评分。应用能做的是保留有序的网络事件，并按请求语义处理失败。

1. 用 NetworkCallback 维护网络状态记录

registerDefaultNetworkCallback() 的当前 API 文档和 Android 17 源码都要求 ACCESS_NETWORK_STATE。Android 开发者指南在机制概述中说明，使用 NetworkCallback 等方式观察连接状态没有统一的额外权限；同一段也要求按具体方法文档检查权限，不能据此省略本方法所需声明。

Android 8.0（API 26）起，新默认网络触发 onAvailable() 后，系统会紧接着按序发送 onCapabilitiesChanged()、onLinkPropertiesChanged() 和 onBlockedStatusChanged() 的初始状态。不要在这些回调中同步查询 getNetworkCapabilities() 或 getLinkProperties()；网络状态可能在收到回调与发起查询之间变化，查询结果会过期或为 null。这段追踪器把回调放到调用方提供的 Handler 消息队列，并为每次新默认网络分配递增序号：

sealed interface DefaultNetworkEvent {
    data class Selected(
        val generation: Long,
        val networkId: String,
        val elapsedNanos: Long,
    ) : DefaultNetworkEvent

    data class Capabilities(
        val generation: Long,
        val networkId: String,
        val wifi: Boolean,
        val cellular: Boolean,
        val vpn: Boolean,
        val internet: Boolean,
        val validated: Boolean,
        val captivePortal: Boolean,
        val notMetered: Boolean,
        val downstreamKbpsEstimate: Int,
        val elapsedNanos: Long,
    ) : DefaultNetworkEvent

    data class Blocked(
        val generation: Long,
        val blocked: Boolean,
        val elapsedNanos: Long,
    ) : DefaultNetworkEvent

    data class Lost(
        val generation: Long,
        val elapsedNanos: Long,
    ) : DefaultNetworkEvent
}

class DefaultNetworkTracker(
    context: Context,
    private val callbackHandler: Handler,
    private val onEvent: (DefaultNetworkEvent) -> Unit,
) : ConnectivityManager.NetworkCallback() {
    private val cm = context.getSystemService(ConnectivityManager::class.java)
    private var current: Network? = null
    private var nextGeneration = 0L

    @Volatile
    var currentGeneration: Long? = null
        private set

    fun start() {
        cm.registerDefaultNetworkCallback(this, callbackHandler)
    }

    fun stop() {
        cm.unregisterNetworkCallback(this)
    }

    override fun onAvailable(network: Network) {
        current = network
        val generation = ++nextGeneration
        currentGeneration = generation
        onEvent(
            DefaultNetworkEvent.Selected(
                generation,
                network.toString(),
                SystemClock.elapsedRealtimeNanos(),
            )
        )
    }

    override fun onCapabilitiesChanged(network: Network, caps: NetworkCapabilities) {
        if (network != current) return
        val generation = currentGeneration ?: return
        onEvent(
            DefaultNetworkEvent.Capabilities(
                generation = generation,
                networkId = network.toString(),
                wifi = caps.hasTransport(NetworkCapabilities.TRANSPORT_WIFI),
                cellular = caps.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR),
                vpn = caps.hasTransport(NetworkCapabilities.TRANSPORT_VPN),
                internet = caps.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET),
                validated = caps.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED),
                captivePortal = caps.hasCapability(
                    NetworkCapabilities.NET_CAPABILITY_CAPTIVE_PORTAL
                ),
                notMetered = caps.hasCapability(
                    NetworkCapabilities.NET_CAPABILITY_NOT_METERED
                ),
                downstreamKbpsEstimate = caps.linkDownstreamBandwidthKbps,
                elapsedNanos = SystemClock.elapsedRealtimeNanos(),
            )
        )
    }

    override fun onBlockedStatusChanged(network: Network, blocked: Boolean) {
        if (network != current) return
        val generation = currentGeneration ?: return
        onEvent(
            DefaultNetworkEvent.Blocked(
                generation,
                blocked,
                SystemClock.elapsedRealtimeNanos(),
            )
        )
    }

    override fun onLost(network: Network) {
        if (network != current) return
        val generation = currentGeneration ?: return
        current = null
        currentGeneration = null
        onEvent(
            DefaultNetworkEvent.Lost(
                generation,
                SystemClock.elapsedRealtimeNanos(),
            )
        )
    }
}

network.toString() 只适合关联同一次设备运行中的事件，不能当作跨重启的稳定标识。linkDownstreamBandwidthKbps 是系统估计值，不能替代应用实测吞吐量。onEvent 回调应只把事件快速放入队列；数据库写入、上传等耗时工作交给其他线程。追踪器还要与进程生命周期一致，并确保只注册一次。系统为每个 UID 合计限制 100 个未释放的网络回调与请求。

2. 在连接层附近区分失败原因

官方文档说明，新连接在默认网络变化后使用新网络，旧默认网络上的既有连接稍后会被系统终止。应用不需要在每次 onAvailable() 时销毁共享 OkHttpClient 或清空整个连接池，这会同时破坏仍可复用的健康连接。

• DNS 返回多个地址时保留全部结果，让 OkHttp 的路由重试与 fast fallback（错开尝试备用地址，以较快成功的连接继续）有选择空间。
• HTTPS URL 始终保留原主机名；把 URL 改成 IP 会破坏 SNI（Server Name Indication，TLS 握手中携带目标主机名的扩展）、证书校验和虚拟主机路由。
• GET 等可安全重试的操作由网络库按配置恢复；POST、支付和提交操作需要幂等键或查询结果接口。幂等键让服务端把相同标识的重复提交识别为同一次操作。
• WebSocket、流式响应和上传任务保存应用层进度，在一次调用明确失败后按协议重连。
• 可延后的后台任务使用 WorkManager（持久后台任务调度库）的网络约束，避免常驻监听器自行轮询。

显式使用非默认网络只适合少数场景，把套接字绑定到后台网络还要求 CHANGE_NETWORK_STATE 权限。获取目标 Network 后，要同时使用 network.socketFactory 建立套接字，并用 network.getAllByName() 在同一网络上解析域名；否则套接字和 DNS 可能经过不同网络。目标网络丢失后，应取消相关请求；若需要单独清理连接，该绑定客户端应使用专用连接池。大多数应用应继续使用系统默认网络。

3. 弱网降级按请求类型分层

超时、并发数、重试次数和恢复时限应来自本项目的实测数据与服务端约定，不存在适用于所有业务的固定数值。

怎样采集系统侧证据

应用日志只能证明应用观察到了什么，不能单独证明系统为何选择某个网络。可复现设备上应同时采集 Connectivity、Wi-Fi 与请求时间线。

dumpsys connectivity

dumpsys 是通过 ADB（Android Debug Bridge，Android 调试桥）导出系统服务内部状态的诊断命令。这条命令保存 ConnectivityService 当前状态：

adb shell dumpsys connectivity > connectivity.txt

输出用于检查 NetworkAgent、网络能力、LinkProperties、验证状态和请求满足关系。LinkProperties 记录接口、地址、路由、DNS、代理等链路配置。系统默认网络不一定等于受 VPN 策略影响后的某个应用默认网络，判断时要结合目标 UID。

检查以下信息：

• 候选 NetworkAgent 是否满足目标请求；
• INTERNET、VALIDATED、CAPTIVE_PORTAL、NOT_METERED 与传输集合；
• LinkProperties 中的 DNS、代理、路由、接口和 MTU（maximum transmission unit，单个链路数据包的最大传输单元）；
• VPN 与底层物理网络是否同时存在；
• 请求与网络的满足关系是否在故障发生的时间段内变化。

dumpsys wifi

这条命令保存 Wi-Fi 服务状态：

adb shell dumpsys wifi > wifi.txt

不同版本和厂商会改变输出字段，不能让解析脚本依赖一段固定文本。人工复核时关注：

• 当前网络、BSSID、频段、RSSI、链路速率与 usability（系统估计的连接可用性）；
• 候选与过滤原因，包括低 RSSI、阻止列表、管理策略和关联拒绝；
• roam（接入点间漫游）、断开原因、认证、关联和 IP 配置失败；
• PNO（preferred network offload，芯片低功耗扫描已保存网络）、MLO、双 STA（同时工作的两个 Wi-Fi 终端接口）、外部评分器与设备资源覆盖；
• 时间戳是否能与应用记录的默认网络序号和请求编号对应。

bugreport

bugreport 是包含多个系统服务状态、日志和配置的诊断包，适合保存难以稳定复现的问题现场：

adb bugreport bugreport-wifi-switch.zip

bugreport 可包含 Connectivity、Wi-Fi、netd、NetworkStack、系统日志和设备配置。netd 是 Android 负责路由、DNS 解析器配置和防火墙等工作的原生网络守护进程；NetworkStack 是承载网络验证等组件的系统模块。采集时记录操作步骤、单调时钟时间、应用请求编号和预期结果。文件可能含网络标识、地址与用户数据，应限制访问，并按隐私策略及时删除。

Perfetto

Perfetto 是 Android 的系统追踪工具，适合判断网络回调之后是否又被线程调度、主线程工作或存储 I/O 延迟：

• 调度事件用于检查回调线程、网络线程和主线程是否长期不可运行；
• android.log 数据源在设备允许时保存 Connectivity、NetworkMonitor、Wi-Fi 与 netd 日志；
• 应用追踪事件（写入系统追踪时间线的自定义记录）标记 onAvailable、能力变化、OkHttp 事件和业务恢复；
• 流量字节使用应用或系统中已经核对过定义和单位的统计源，不假设每台设备都提供某个 Perfetto 网络计数器。

应用事件、系统追踪与服务端日志至少要共享请求编号，并记录单调时钟与墙上时钟的对应关系。缺少这种关联时，只能知道“切网和超时发生在相近时间”，不能确认两者有因果关系。

OEM 差异与 HTTP/3 切网边界

OEM Wi-Fi 评分为何不同

AOSP 的 Connectivity 选择逻辑位于 Mainline 模块，也就是可独立于整机系统版本更新的一类模块化系统组件。设备厂商能通过 NetworkScore 属性表达网络策略，也能通过 Wi-Fi 资源覆盖、HAL（hardware abstraction layer，连接系统框架与厂商实现的硬件抽象层）、芯片固件、内核驱动、漫游策略、双 STA 和厂商服务改变 Wi-Fi 行为。

WifiManager.WifiConnectedNetworkScorer 是只向特定系统组件开放的 @SystemApi，并要求签名级权限 WIFI_UPDATE_USABILITY_STATS_SCORE，普通第三方应用不能把它当成公开扩展点。Android 17 的 ScoreUpdateObserver 对各回传值给出了明确边界：

• notifyScoreUpdate() 的数值只用于 Wi-Fi 统计，不直接驱动网络选择；
• notifyStatusUpdate() 可报告当前连接是否可用；
• requestNudOperation() 请求一次 NUD（neighbor unreachability detection，邻居不可达检测），用来确认同一链路上的网关等邻居是否仍可达；
• blocklistCurrentBssid() 建议暂时阻止当前 BSSID；
• 受功能标志控制的 setPreEvaluationEnabled() 可让下一次连接先进入受限预评估，再决定是否向其他应用开放。功能标志是系统构建或运行时用来开关一项行为的配置。

外部评分器的输入可来自 WifiUsabilityStatsEntry，包括 RSSI、链路速率、频率和数据包统计。接口存在不代表每台设备都安装了外部评分器，也不代表设备启用了 Android 17 源码中由功能标志控制的行为。

工程判断要分三层：

跨机型实验应固定 AP、频段、信道、业务请求、服务端和干扰条件，用可控衰减逐步改变信号，并同时记录默认网络序号、能力、候选原因、HTTP 时间线、切换次数和功耗。单台设备的一次观察不能代表整个平台的规律。

HTTP/3、QUIC 与网络切换

示例中的 EventListener 代码与正文统一以 OkHttp 5.4.0 为锚点。OkHttp 自带传输实现支持 HTTP/1.1 与 HTTP/2，不直接提供 HTTP/3。HTTP/3 运行在 QUIC 传输协议之上；需要它时，应评估 Android HttpEngine（平台网络引擎 API）、Cronet（Chromium 网络栈的 Android 库），或官方提供的 Cronet Transport for OkHttp 集成。

QUIC 用连接 ID 标识一条逻辑连接，不把连接身份完全绑定在原来的 IP 地址和端口上，因此具备连接迁移的协议基础。迁移仍不会因使用 HTTP/3 自动发生。HttpEngine 和 Cronet 都提供连接迁移选项；只有启用默认网络迁移、请求使用 QUIC 且服务端支持迁移时，活动连接才有机会在网络变化后继续。允许迁往非默认网络还可能使用按量计费的流量。

分批启用 HTTP/3 时，至少分别记录：

• 实际协商协议与默认网络序号；
• QUIC 建连、迁移尝试、迁移结果，以及改用 HTTP/2 的原因；
• HTTP/3 与 HTTP/2 各自的请求分布和失败分类；
• 切网前后的长连接恢复；
• 非默认计费网络的使用情况。

支付、下单和上传仍需幂等与恢复协议。连接迁移只能改变传输连续性，不能提供业务一致性。协议细节见 24.6 HTTP/2、HTTP/3、gRPC 与 ECH。

工程检查清单

• 默认网络由 registerDefaultNetworkCallback() 持续观测，回调与进程生命周期一致。
• INTERNET、VALIDATED、CAPTIVE_PORTAL、NOT_METERED 和传输集合分别记录。
• 新默认网络用 onAvailable() 识别，没有等待旧网络 onLost()。
• OkHttp 保存完整事件序列，多次交换不会覆盖前一组时间戳。
• 请求编号、默认网络序号、系统追踪与服务端日志能够关联。
• 大文件任务依据计费能力、用户意图与持久任务状态执行。
• DNS、连接、TLS 与业务重试都保留失败分类和幂等边界。
• VPN、OEM 配置、MLO、双 STA 与 HTTP/3 结论都有对应设备证据。

全文小结

Wi-Fi 模块负责在候选 AP 与 BSSID 中做无线侧选择，Connectivity 模块再依据 NetworkRequest、能力与系统策略选择默认 Network。RSSI、Wi-Fi 图标、VALIDATED 和业务可用性分属不同层，应用不应试图用一个自定义分数复刻系统决策。

工程观测要把默认网络世代、NetworkCapabilities、OkHttp 完整事件序列、系统证据和服务端请求编号关联起来。OEM 评分、双 STA、MLO 与 HTTP/3 连接迁移都必须用目标设备证据验证；传输连续性也不能替代业务幂等和恢复协议。

参考资料

• AOSP android-17.0.0_r1 · WifiNetworkSelector.java
• AOSP android-17.0.0_r1 · WifiCandidates.java
• AOSP android-17.0.0_r1 · ThroughputScorer.java
• AOSP android-17.0.0_r1 · ScoringParams.java
• AOSP android-17.0.0_r1 · WifiManager.java
• AOSP android-17.0.0_r1 · NetworkScore.java
• AOSP android-17.0.0_r1 · ConnectivityManager.java
• AOSP android-17.0.0_r1 · NetworkRanker.java
• AOSP android-17.0.0_r1 · FullScore.java
• AOSP android-17.0.0_r1 · NetworkMonitor.java
• Android Open Source Project · Wi-Fi network selection
• Android Open Source Project · Network selection
• Android Developers · Read network state
• Android Developers · ConnectivityManager
• Android Developers · ConnectivityManager.NetworkCallback
• Android Developers · Network
• Android Developers · NetworkCapabilities
• Android Developers · Define work requests
• Android Developers · HttpEngine.Builder
• Android Developers · ConnectionMigrationOptions.Builder
• Android Developers · Network stacks
• Android Developers · Use Cronet with other libraries
• OkHttp · Connections
• OkHttp 5.4.0 · EventListener.kt
• OkHttp · Changelog