常见问题

为什么钰信 Web 能打开但登录或收消息失败？

页面域名 im.shengyukj.top 只提供 Flutter Web 静态资源。HTTP API 应使用 https://apisaas.shengyukj.top/app-api，IM WebSocket 应使用 wss://apisaas.shengyukj.top/ws。检查 Flutter 编译参数、Nginx /app-api 与 /ws 反代，以及 9000 端口容器监听状态。

图片上传提示 413 或服务器异常怎么办？

确认 API Nginx server 块设置 client_max_body_size 200m，后端 spring.servlet.multipart.max-file-size 与请求上限匹配，文件目录可写且被正确挂载到容器。不要只修改前端限制。

对方接听后通话一直转圈或自动挂断？

先验证 rtc 域名的 WSS 证书，再检查安全组和服务器防火墙：7881/tcp、7882/udp、443/udp、41000-41040/udp。LiveKit 发布的节点 IP 必须是公网可路由地址，不能是 Docker 172.x 网段。

Android 为什么不能覆盖安装？

新 APK 的包名和签名证书必须与已安装版本一致，且 versionCode 必须递增。调试签名包不能覆盖正式签名包；首次从调试包迁移时需卸载旧包后再安装正式包。

上传 APK 后用户为什么收不到更新？

确认平台后台记录已经“发布”而非草稿或暂停；应用标识、平台和渠道应分别为 yuxin、android、prod；构建号必须大于客户端构建号。用户可在“关于钰信”手动检查，普通更新不会发送系统推送通知。

官网为什么必须使用 HTTPS？

HTTPS 保护访问和搜索引擎收录，也避免浏览器将跳转到管理端、下载页或 WebSocket 的链接标为不安全。官网、API、钰信 Web 和 RTC 域名都应有有效证书并从 HTTP 重定向到 HTTPS。