maidong-ktv

52 Commits 1 Branch 9 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
zijunchiang	0cffd08789	V1.4.6: 点歌取址失败——修裸 Socket 通道两处缺陷 + 打通 JS 侧日志现象: 曲库正常后点歌失败「详情=无法生成下载地址」，且远程日志里没有任何线索。排查(本地复现源站协议): - 用同一套签名从本机请求 i.php / music/do.php 全部正常，能拿到这首歌的真实地址；换 App 注入的版本号(VER=2.0/VN=4.1.3.03281430) 也正常 → 源站没问题，是设备侧。 - 根因在 KtvJsBridge.rawRequest() 这条裸 Socket 通道（点歌取址正是走它）: 1. 连接阶段没有超时: `Socket(host, port)` 不受 soTimeout 约束，遇路由黑洞按系统 TCP 超时(~2min)干等；7 个源叠加远超 JS_REQUEST_TIMEOUT_MS(180s) → 桥返回空 → 「无法生成下载地址」，而日志里连失败都没有（请求还没失败）； 2. HTTPS 分支用 SSLSocketFactory.getDefault()，既不受 HttpsURLConnection.setDefaultSSLSocketFactory 影响，也不受 network_security_config 约束 → 老设备缺 ISRG 新根时握手必失败。修复: - rawRequest 连接改为显式 connect(timeout): Socket().connect(InetSocketAddress, t)； HTTPS 改用 TlsCompat.sslSocketFactory()（系统信任 ∪ 内置根证书）。 - TlsCompat 暴露 sslSocketFactory()，并按 API 分级: 裸通道始终用增强工厂， HttpsURLConnection 默认工厂仅在 API<24 接管。 - 裸通道失败上报 RAW-ERR（原来只在 logcat）。 - 打通 JS 侧日志: wrapHtml 注入 console 桥，把 ktv_api.js 的 _log()/console.log 转发到 android.log → MiliLog("JS ...")；点歌失败时可通过「JS ...」逐步过程 + 「点歌失败 ... 详情=」汇总原因定位。版本 1.4.5(25) 到 1.4.6(26)；签名证书不变。ktv_api.js 未改动，KTV_BRIDGE_API 仍为 8。	2026-09-26 16:59:43 +08:00
zijunchiang	62216b0fb8	V1.4.3: 修复老系统(API<24)不认 Let's Encrypt 新根，导致无法下载曲库根因（用远程日志的 STORAGE 行 + 本地复现 Muse 协议定位）: - 曲库服务 mconn.cherryonline.cn 与点歌登录 mws.cherryonline.cn 都用 Let's Encrypt 新链 leaf ← YR2 ← Root YR ← ISRG Root X1。 - res/xml/network_security_config.xml 里虽然已把这三个根加为信任锚，但该配置只在 Android 7.0(API 24)+ 被系统读取；Android 5.1.1 上被完全忽略，系统信任库又没有 ISRG 新根 → SSLHandshakeException: Trust anchor for certification path not found → login 失败 → fetchVersion()=null → 根本不触发下载，界面只剩兜底文案「未找到可用曲库」，而失败只写 logcat，远程日志里看不到。 - 这也解释了为什么只有这台老设备出问题（其它设备都 >= API 24）。修复: - 新增 TlsCompat: 在 API<24 上把「系统默认信任 ∪ 内置根证书」的复合 X509TrustManager 装到全局 HttpsURLConnection.setDefaultSSLSocketFactory，覆盖 App 内所有 HttpsURLConnection （曲库同步/JS 热更新下载/更新检查/头像下载）。主机名校验保持系统默认，不放行任意证书。 - WebView 的 TLS 无法用 SSLContext 覆盖（JS 会直连 mws）: 在 KtvJsBridge 的 onReceivedSslError 里不盲目 proceed，先用 TlsCompat.isHostTrustedByOurStore(host) 对同一主机独立校验，通过才放行。 - TlsCompat.install 在 KtvApplication.attachBaseContext 调用（早于任何网络请求）。 - 补齐可观测性: 曲库同步每一步失败改为 MiliLog 上报 (MUSE-DB login/sync ...、DB-SYNC download failed/空间不足/成功)； fetchRemoteVersion 失败时设置明确的 bootstrapError，不再只显示兜底文案。 - AGENTS.md 增补「老系统 TLS 根证书」条目。版本 1.4.2(22) → 1.4.3(23)；签名证书不变。	2026-09-26 16:06:27 +08:00

Author

SHA1

Message

Date

zijunchiang

0cffd08789

V1.4.6: 点歌取址失败——修裸 Socket 通道两处缺陷 + 打通 JS 侧日志

现象: 曲库正常后点歌失败「详情=无法生成下载地址」，且远程日志里没有任何线索。

排查(本地复现源站协议):
- 用同一套签名从本机请求 i.php / music/do.php 全部正常，能拿到这首歌的真实地址；
  换 App 注入的版本号(VER=2.0/VN=4.1.3.03281430) 也正常 → 源站没问题，是设备侧。
- 根因在 KtvJsBridge.rawRequest() 这条裸 Socket 通道（点歌取址正是走它）:
  1. 连接阶段没有超时: `Socket(host, port)` 不受 soTimeout 约束，遇路由黑洞按系统
     TCP 超时(~2min)干等；7 个源叠加远超 JS_REQUEST_TIMEOUT_MS(180s) →
     桥返回空 → 「无法生成下载地址」，而日志里连失败都没有（请求还没失败）；
  2. HTTPS 分支用 SSLSocketFactory.getDefault()，既不受
     HttpsURLConnection.setDefaultSSLSocketFactory 影响，也不受
     network_security_config 约束 → 老设备缺 ISRG 新根时握手必失败。

修复:
- rawRequest 连接改为显式 connect(timeout): Socket().connect(InetSocketAddress, t)；
  HTTPS 改用 TlsCompat.sslSocketFactory()（系统信任 ∪ 内置根证书）。
- TlsCompat 暴露 sslSocketFactory()，并按 API 分级: 裸通道始终用增强工厂，
  HttpsURLConnection 默认工厂仅在 API<24 接管。
- 裸通道失败上报 RAW-ERR（原来只在 logcat）。
- 打通 JS 侧日志: wrapHtml 注入 console 桥，把 ktv_api.js 的 _log()/console.log
  转发到 android.log → MiliLog("JS ...")；点歌失败时可通过
  「JS ...」逐步过程 + 「点歌失败 ... 详情=」汇总原因定位。

版本 1.4.5(25) 到 1.4.6(26)；签名证书不变。ktv_api.js 未改动，KTV_BRIDGE_API 仍为 8。

2026-09-26 16:59:43 +08:00

zijunchiang

62216b0fb8

V1.4.3: 修复老系统(API<24)不认 Let's Encrypt 新根，导致无法下载曲库

根因（用远程日志的 STORAGE 行 + 本地复现 Muse 协议定位）:
- 曲库服务 mconn.cherryonline.cn 与点歌登录 mws.cherryonline.cn 都用 Let's Encrypt 新链
  leaf ← YR2 ← Root YR ← ISRG Root X1。
- res/xml/network_security_config.xml 里虽然已把这三个根加为信任锚，但
  **该配置只在 Android 7.0(API 24)+ 被系统读取**；Android 5.1.1 上被完全忽略，
  系统信任库又没有 ISRG 新根 → SSLHandshakeException: Trust anchor for certification
  path not found → login 失败 → fetchVersion()=null → 根本不触发下载，
  界面只剩兜底文案「未找到可用曲库」，而失败只写 logcat，远程日志里看不到。
- 这也解释了为什么只有这台老设备出问题（其它设备都 >= API 24）。

修复:
- 新增 TlsCompat: 在 API<24 上把「系统默认信任 ∪ 内置根证书」的复合 X509TrustManager
  装到全局 HttpsURLConnection.setDefaultSSLSocketFactory，覆盖 App 内所有 HttpsURLConnection
  （曲库同步/JS 热更新下载/更新检查/头像下载）。主机名校验保持系统默认，不放行任意证书。
- WebView 的 TLS 无法用 SSLContext 覆盖（JS 会直连 mws）: 在 KtvJsBridge 的
  onReceivedSslError 里不盲目 proceed，先用 TlsCompat.isHostTrustedByOurStore(host)
  对同一主机独立校验，通过才放行。
- TlsCompat.install 在 KtvApplication.attachBaseContext 调用（早于任何网络请求）。
- 补齐可观测性: 曲库同步每一步失败改为 MiliLog 上报
  (MUSE-DB login/sync ...、DB-SYNC download failed/空间不足/成功)；
  fetchRemoteVersion 失败时设置明确的 bootstrapError，不再只显示兜底文案。
- AGENTS.md 增补「老系统 TLS 根证书」条目。

版本 1.4.2(22) → 1.4.3(23)；签名证书不变。

2026-09-26 16:06:27 +08:00