初始化失败主因是AccessKey非主账号或未授权AliyunNlsFullAccess且开启“全部资源”；须用环境变量加载密钥、SDK≥v2.2.0；TTS需UTF-8纯文本≤300字符并设正确Content-Type；ASR须CLI守护进程、手动心跳、PCM分片；autoload失效多因未执行composer install。
阿里云 PHP SDK 初始化失败：Client 构造报错 InvalidAccessKeyId.NotFound
多数人卡在这一步不是密钥写错了，而是没搞清「AccessKey 是谁的」。必须用主账号或具备 AliyunNlsFullAccess 权限的子账号的 AccessKeyId 和 AccessKeySecret，RAM 子账号若只给了语音相关权限但没勾选「允许调用 OpenAPI」也会静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 去
https://ram.console.aliyun.com/users确认子账号「授权策略」里含AliyunNlsFullAccess，且「授权应用范围」选「全部资源」 - 初始化时别硬编码密钥，改用环境变量：
getenv('ALIYUN_ACCESS_KEY_ID')，避免误提交到 Git - SDK 版本必须 ≥
v2.2.0，老版本不支持新版 STS 临时 token 和 HTTPS 默认强制
NlsClient 合成语音返回空响应或 400 Bad Request
根本原因常是请求体格式不对——阿里云语音合成（TTS）要求 text 字段必须是 UTF-8 编码的纯文本，且不能含 HTML 标签、控制字符或超过 300 字符（免费版限制）。很多人直接传 $_POST['content'] 进去，没做 trim() 和 mb_substr($text, 0, 300, 'UTF-8')。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 合成前强制转码：
mb_convert_encoding($text, 'UTF-8', 'auto')，否则中文会变乱码导致 400 -
voice参数填xiaoyun没问题，但rate超过300或volume超过100会直接拒掉整条请求 - 不要用
file_get_contents()直接发 POST，要用cURL并显式设Content-Type: application/json
PHP 实现语音识别（ASR）时 WebSocket 连接频繁断开
阿里云实时语音识别（RecognizeSpeech）依赖长连接，PHP-FPM 默认超时 30 秒，而语音识别需持续收流。直接在 Web 请求里跑 WebSocket 会触发 FPM worker 超时 kill，不是网络问题，是进程生命周期冲突。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别在 Apache/Nginx 的 PHP 请求里启 WebSocket 客户端，改用 CLI 模式跑守护进程：
php /path/to/asr_worker.php - WebSocket 心跳必须手动实现：每 15 秒发一次
{"action":"ping"}，服务端 30 秒没收到会主动断连 - 音频数据要分片推送，单次
send()不得超过 64KB，且必须是 PCM 编码（16bit 小端，16kHz 单声道），用file_get_contents()读 WAV 文件后得先 strip header
本地开发调试时 aliyun-openapi-php-sdk 报 Class 'AlibabaCloud\Client\AlibabaCloud' not found
Composer 自动加载失效最常见于两个地方：一是没执行 composer install（只复制了 vendor 文件夹），二是用了旧版 PHP（guzzlehttp/guzzle v7 不兼容。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 删掉整个
vendor目录，用php -v确认当前 CLI 版本 ≥ 7.2，再运行composer require alibabacloud/client - 如果项目已用 Laravel，别在
config/app.php里注册 ServiceProvider，阿里云 SDK 是无框架设计，直接 new 即可 - IDE 警告
Class not found但运行正常？大概率是 PHPStorm 没识别 Composer autoload —— 右键项目 →Composer→Reload project
