遇到美洽语音发不出去，先别慌：先检查手机或电脑网络、麦克风权限及美洽是否为最新版；尝试重启应用或设备、清理缓存；若仍失败，导出日志并联系美洽客服或运维，附上设备型号、系统版本、出问题的具体时间和复现步骤。另外，测试同一网络下其他账号或设备，可快速定位是网络、账号、设备还是美洽服务器问题。并记录详细日志。
为什么先给出这些“简单动作”
就像汽车发动不上，先看燃油、点火和电瓶一样，语音发不出去通常也是权限、网络或软件版本三类问题在作怪。先排掉这些“低垂的果实”，能快速把问题范围缩小一半，这样后面再抓日志和深层排查就有的放矢。
快速排查清单（按从易到难）
- 网络：切换 Wi‑Fi 与 4G/5G；试试另一个网络。
- 权限：麦克风、存储、后台活动权限是否允许。
- 版本：美洽 App/SKD/Web SDK 是否为最新版。
- 重启：重启应用，必要时重启设备。
- 缓存/数据：清理缓存或卸载重装。
- 对端与服务器：确认对方网络正常，检查美洽服务状态公告。
移动端（iOS/Android）常见原因与处理
权限与设置
移动端占比很大。最常见的是用户曾拒绝麦克风权限，导致录音权限被永久禁止。iOS 需要在“设置→隐私→麦克风”打开应用权限；Android 要在“应用权限/权限管理”里开启 RECORD_AUDIO 和存储权限。
系统策略与耗电优化
一些厂商（例如华为、小米）会对后台活动做强限制，导致录音或上传在后台被杀。建议把美洽列入“自启/后台白名单”。
音频采样率和编码
部分机型对编码器支持有限（比如某些 AAC 变体或 OPUS 实现）。如果 SDK 要求特定格式，检查录制参数（采样率 16k/8000、通道单声道）是否与服务端兼容。
网页版（Chrome/Firefox/Safari）常见问题
HTTPS 与 getUserMedia
浏览器只在安全上下文（HTTPS 或 localhost）允许麦克风。若站点在 HTTP，getUserMedia 会被拒绝。
站点设置与第三方 Cookie
用户可能在浏览器站点设置里拒绝了麦克风或自动播放。检查页面右侧或地址栏的摄像头/麦克风图标授权。
WebRTC 与信令
若美洽使用 WebRTC，问题可能出在信令或 TURN/STUN 服务器。浏览器控制台和 Network 面板会有明显的 ICE、DTLS、TURN 连接失败日志。
服务端与上传问题
如果是上传失败而非本地录制失败，要检查：
- HTTP 返回码（401、403、413、500 等）
- 文件大小限制与超时配置
- 证书信任链（TLS 报错会阻止上传）
- 跨域（CORS）策略
如何收集有用日志（让客服能快速定位）
好的日志能把问题从“它不工作”变成“404 错”或“ICE 失败”。以下是实操步骤：
- 时间点：精确到分钟甚至秒，标注时区。
- 设备信息：厂商、型号、系统版本、App 版本或浏览器版本。
- 网络类型：Wi‑Fi/移动网络，是否使用代理或 VPN。
- 复现步骤：从打开应用到点击录音的每一步。
- 错误截图/控制台：手机截图或浏览器控制台完整日志。
- 日志文件：Android 用 adb logcat，iOS 用 Xcode device logs，Web 用 HAR（Network）文件。
示例：怎么写一份有用的工单
下面是一份简短模板，复制粘贴改成具体信息即可。
- 发生时间：2026‑06‑15 14:23:12（UTC+8）
- 设备/浏览器：小米 11 / Android 13 / 美洽 SDK vX.Y.Z
- 网络：移动网络（China Mobile 4G）
- 复现步骤：1）打开会话 2）点击“语音” 3）录制 3 秒后点击发送 → 失败，无提示或提示“上传失败”
- 附件：adb logcat（相关时间段）、应用日志、网络 HAR 文件、截图
排查示例流程（像实验一样一步步验证）
把排查流程当成实验设计：每次只改一项，观察结果，记录结论。
- 本地录音测试：用系统录音或语音备忘录录一段，确认硬件与系统录音正常。
- 同网络不同设备：在同一 Wi‑Fi 下换一台手机或电脑，测试是否能发送。
- 同设备不同网络：切换到热点或别的 Wi‑Fi，测试。
- 浏览器/客户端切换：如果是 Web，换 Chrome/Edge；如果是 App，尝试卸载重装或用旧版 SDK。
- 查看服务状态：关注美洽平台公告或状态页，有时候是短暂的服务端故障。
常见错误码与含义（速查表）
| 错误码/表现 | 可能原因 | 建议操作 |
| 401 / 403 | 鉴权失败、签名过期、token 错误 | 刷新 token，检查时间同步与签名逻辑 |
| 413 | 文件过大 | 分片上传或限制文件时长/码率 |
| 网络超时 / 504 | 网络不稳定或后端处理慢 | 重试、换网络或联系运维查看后端队列 |
| WebRTC ICE 失败 | STUN/TURN 不可达或被防火墙阻断 | 检查 TURN 配置、端口与证书 |
临时应急方案（能快速恢复沟通的办法）
- 让用户先发送文字或语音文件（比如用手机录音后作为文件上传）。
- 使用第三方短链或云盘上传录音文件，再把链接发给对方。
- 换到语音通话或视频通话，绕过语音消息上传链路。
如果所有自查都失败，如何高效地与美洽支持沟通
把上面“如何收集日志”和“示例工单”结合起来，另外注意两点：一是提供可复现路径；二是给出你已经尝试过的排查项（比如“已换网/已重装/已更新 SDK”）。这样支持团队能少来回问诊，定位更快。
小技巧与经验（来自运维和一线客服）
- 时间戳很重要：服务端日志以秒为单位检索，如果没有精确时间，查找成本成倍增长。
- 在高并发时间段，短暂失败较常见，先做重试策略再报警。
- 保留最近 7 天的日志和异常样本，有助于做频次分析与回溯。
排查语音不能发送的过程有点像拆家电：先抬开外壳（权限和网络），再看电路（SDK 与服务器），最后测电流（日志与抓包）。如果你愿意，我可以把上面的排查清单做成可复制的工单模板，或者根据你提供的具体错误代码和日志帮你逐行分析，那样一般能更快找到真正的症结。