getID3::analyze() 返回空 tags 的主因是默认不启用标签解析，需显式设置 option_tag_id3v2 和 option_tag_id3v1 为 true；其次常见原因包括文件不可读、ID3v2 编码声明与实际内容不符（如声明 UTF-8 实际为 GBK）、传入远程 URL 而非本地路径、以及未捕获异常导致静默失败。
直接用 getID3 或 Mp3Info 就能读取大多数音频文件的元数据，但选错库、漏配参数、忽略编码或权限问题，会导致字段为空、乱码、崩溃或静默失败。
为什么 getID3::analyze() 返回空 tags？
常见现象是 $fileInfo['tags'] 为 null 或只含 error 字段，而非预期的 id3v2 或 id3v1 结构。
- 没启用标签解析：
getID3默认只分析技术信息（时长、码率等），必须显式调用$getID3->setOption(array('option_tag_id3v2' => true, 'option_tag_id3v1' => true)) - 文件路径不可读：PHP 进程无权访问该路径，或文件被其他进程锁定；用
is_readable('path/to/file.mp3')先验证 - ID3v2 编码异常：某些工具写入了非标准 UTF-16BE 或带 BOM 的 ID3v2，
getID3默认只尝试 ISO-8859-1 和 UTF-8；可临时加$getID3->setOption(array('encoding' => 'UTF-8'))强制解码 - 远程 URL 不支持直接传入：
$getID3->analyze('https://...')会失败；必须先file_get_contents()或curl下载到临时文件再分析
Mp3Info 读不到 artist/title？检查构造参数和异常捕获
Mp3Info 默认不解析 ID3 标签，只返回技术元数据（如采样率、帧数），这是最常被忽略的默认行为。
- 第二个参数必须为
true：创建实例时写成new Mp3Info('song.mp3', true)，否则$audio->getArtist()永远返回空字符串 - MP3 文件不含 ID3v1/v2：有些录音笔或转码工具生成的 MP3 根本没标签；可用
ffprobe -v quiet -show_entries format_tags=artist -of default song.mp3交叉验证 - 字段名大小写敏感：
$audio->getArtist()有效，但$audio->artist是未定义属性；别混用魔术方法和公共属性 - 没包好 try/catch：标签损坏时会抛
RuntimeException，不捕获就中断脚本；务必包裹解析逻辑
中文乱码、特殊字符显示为问号？别只怪编码
乱码根源不在 PHP 环境，而在 ID3 标签本身的编码声明与实际内容不一致——尤其常见于 Windows 下用旧版千千静听、酷狗写入的文件。
- ID3v2.3 声明 UTF-8，但实际存的是 GBK 字节：此时
getID3按声明解码必然出错；可手动提取原始字节后用mb_convert_encoding($raw_bytes, 'UTF-8', 'GBK')补救 - ID3v1 固定 ISO-8859-1：它根本不支持中文，所谓“中文 ID3v1”本质是系统本地编码（如 GB2312）硬塞进去，
Mp3Info无法自动识别，需自行检测并转码 - 输出终端/浏览器未声明 UTF-8：
echo $fileInfo['tags']['id3v2']['title'][0]正确取出后，若页面 HTML 缺少<meta charset="UTF-8">，仍显示乱码 - 别依赖
iconv()：它对非法 UTF-8 字节序列会直接报错；优先用mb_convert_encoding($str, 'UTF-8', 'auto')并设第三个参数为'auto'
批量处理大量音频时性能卡顿？缓存和并发要一起上
单次 analyze() 耗时 50–200ms，处理 1000 个文件就是几分钟——这不是代码慢，是没绕过重复 I/O 和解析开销。
- 启用 SQLite3 缓存：加载
getid3/extension.cache.sqlite3.php后，首次分析结果自动存入getid3_cache.db，后续相同文件 md5 匹配即跳过解析 - 避免反复 new getID3()：把实例复用在循环外，否则每次新建对象都重载配置和扩展
- 别用 PHP 多线程（pthreads 已废弃）：改用
pcntl_fork()或移交至队列（如 Redis + Supervisor）；更简单的是 shell 层面并行：find ./music -name "*.mp3" | xargs -P 4 -I {} php extract.php {} - 预过滤文件：先用
file -b或finfo_open()快速排除非音频文件（如 .txt、.jpg），省掉无效解析
真正麻烦的不是读不出字段，而是读出来之后发现：同一首歌在不同设备上显示不同艺术家名，或者 TXXX 自定义帧里存了版权信息却没人读——这些细节不会报错，但会让业务逻辑悄悄出错。
