# WebSSH 终端无法输入修复

**日期**: 2026-05-26
**变更摘要**: 修复 WebSSH 终端连接建立后立即断开、无法输入的问题

## 动机

1. WebSocket 连接建立后几秒内就断开（wsState=CLOSED），用户无法在终端输入
2. 后端日志报 `WebSSH shell creation failed: ` 错误消息为空，无法诊断
3. `finally` 块双重关闭 WebSocket 导致 `Unexpected ASGI message 'websocket.close'` 异常
4. 连接池复用的旧连接可能已失效（TCP连接在但SSH通道损坏），`create_process` 抛空消息异常

## 变更内容

### server/api/webssh.py — 3个bug修复
- **失效连接重试**: `create_process` 失败时，强制关闭池中旧连接，用新连接重试一次
- **异常信息改进**: `logger.error` 改用 `{type(e).__name__}: {e!r}` 避免空消息
- **双重关闭修复**: 引入 `ws_closed` 标志，异常分支 close 后 finally 不再重复 close
- 所有 `websocket.close()` 调用增加 try/except 防护

### web/app/terminal.html — Alpine 初始化竞态修复
- `$d()` 函数加 try/catch：Alpine 未加载时返回默认对象而非抛 `ReferenceError`
- 消除 `ResizeObserver fit error: ReferenceError: Alpine is not defined` 控制台警告

## 涉及文件

- `server/api/webssh.py` — WebSSH WebSocket 处理
- `web/app/terminal.html` — 前端终端页面

## 是否需迁移/重启

- 需重启后端（webssh.py 修改）
- terminal.html 静态文件无需重启

## 验证方式

1. 打开 terminal.html?server_id=8 → WebSocket 保持 OPEN
2. 输入 `whoami` → 回显 `root`
3. 后端日志无 `shell creation failed` 和 `Unexpected ASGI message` 错误
4. 控制台无 `Alpine is not defined` 警告
