
android端chrome浏览器在chromecast投屏过程中,若遭遇网络断开、接收设备断电或wi-fi关闭等异常情况,页面会无提示强制退出;该问题在windows平台未复现,根本原因在于`session.sendmessage()`调用缺乏前置健壮性校验。
在基于Cast SDK的Web投屏应用中,session.sendMessage() 是向已连接的Chromecast接收端发送消息的核心API。然而,在Android Chrome(v83–v98.0.4758.101)中,该方法在底层网络通道不可达时不会抛出JavaScript错误,也不会触发onError或onDisconnect事件,而是直接引发浏览器进程崩溃(表现为标签页静默关闭),且ADB日志、chrome://crashes及前端window.onerror均无有效线索——这正是该问题难以调试的关键。
为规避此缺陷,必须在每次调用 session.sendMessage() 前实施三重主动健康检查,确保通信链路处于可预期的稳定状态:
async function safeSendMessage(session, namespace, data) {
// 1. 检查Cast会话是否活跃且未终止
if (!session || session.status !== chrome.cast.SessionStatus.ACTIVE) {
console.warn('Cast session is not active');
await cleanupSession(session);
return false;
}
// 2. 检查浏览器网络连通性(客户端层面)
if (!navigator.onLine) {
console.warn('Navigator reports offline');
await cleanupSession(session);
return false;
}
// 3. 执行轻量级网络探活(推荐使用HEAD请求或短超时GET)
try {
const res = await fetch('/api/health', {
method: 'HEAD',
cache: 'no-cache',
signal: AbortSignal.timeout(2000)
});
if (!res.ok) throw new Error(`Health check failed: ${res.status}`);
} catch (err) {
console.warn('Network health check failed:', err);
await cleanupSession(session);
return false;
}
// 全部通过后才执行实际发送
try {
await session.sendMessage(namespace, data);
return true;
} catch (err) {
console.error('sendMessage failed unexpectedly:', err);
await cleanupSession(session);
return false;
}
}
async function cleanupSession(session) {
if (session && session.endSession) {
try {
await session.endSession();
} catch (e) {
console.debug('Session cleanup ignored:', e);
}
}
}⚠️ 关键注意事项:
- navigator.onLine 仅反映操作系统网络接口状态,不能替代真实HTTP探测(例如Wi-Fi已连但网关失联);务必叠加服务端健康检查。
- 避免在message回调中直接调用sendMessage形成递归风险;所有发送逻辑应统一走safeSendMessage封装。
- 健康检查引入的延迟(通常
- 建议在session.addUpdateListener中监听SessionStatus.STOPPED或SessionStatus.INVALID,并同步清理本地会话引用,防止内存泄漏。
综上,这不是SDK Bug的修复,而是对Android Chrome底层不兼容行为的必要防御性编程。将“假设连接可靠”转变为“验证后才通信”,是构建高可用投屏Web应用的必备实践。










