Java 18 Spring Boot应用中正确合并MP3字节数组的方法

问题根源 #

MP3不是随便把字节拼在一起就能正常工作的：每个独立MP3文件都带自己的ID3元数据头部和一系列音频帧。直接拼接多个MP3的字节数组时，播放器会把第一个文件的头部当成整个合并文件的唯一头部，但这个头部里的长度信息只对应第一个文件，自然就会出现「下载后文件长度和第一个文件一致、部分播放器无法播放到结尾」的问题。

解决方案 #

方案一：手动处理（适合理解原理） #

核心思路是去掉每个MP3的独立头部，只拼接纯音频帧，最后可选添加统一的新头部。

1. 剥离每个MP3的ID3v2头部
   MP3的ID3v2头部在文件开头，以ID3标识，需要识别并跳过。代码示例：

   private static byte[] stripId3Header(byte[] mp3Bytes) {
       // 检查是否存在ID3v2头部
       if (mp3Bytes.length < 3 || !(mp3Bytes[0] == 'I' && mp3Bytes[1] == 'D' && mp3Bytes[2] == '3')) {
           return mp3Bytes;
       }
       // 计算ID3v2头部总长度（基础头10字节 + 扩展内容长度）
       int headerContentLength = ((mp3Bytes[6] & 0xFF) << 21) | ((mp3Bytes[7] & 0xFF) << 14) 
                               | ((mp3Bytes[8] & 0xFF) << 7) | (mp3Bytes[9] & 0xFF);
       int totalHeaderSize = 10 + headerContentLength;
       
       if (totalHeaderSize >= mp3Bytes.length) {
           return new byte[0]; // 异常情况返回空字节数组
       }
       // 截取去掉头部后的纯音频帧部分
       return Arrays.copyOfRange(mp3Bytes, totalHeaderSize, mp3Bytes.length);
   }
   

2. 拼接所有音频帧字节
   把每个MP3剥离头部后的字节数组，按顺序拼接成一个大字节数组。
3. 添加统一ID3头部（可选）
   如果需要给合并后的文件添加标题、作者等元数据，可以生成新的ID3v2头部，拼在音频帧字节的最前面。如果不需要，直接用拼接后的音频帧字节即可，多数播放器能识别流式MP3。

方案二：用成熟音频库（推荐，减少bug） #

直接用专门处理MP3的库，比如JAudiotagger，它会自动处理头部和帧的逻辑：

import org.jaudiotagger.audio.mp3.MP3File;
import org.jaudiotagger.tag.Tag;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;

public class Mp3Merger {
    public static byte[] mergeMp3s(byte[]... mp3BytesArray) throws IOException {
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        Tag mergedTag = null;

        for (byte[] mp3Bytes : mp3BytesArray) {
            ByteArrayInputStream inputStream = new ByteArrayInputStream(mp3Bytes);
            MP3File mp3File = new MP3File(inputStream);
            
            // 只保留第一个文件的标签作为合并后文件的标签
            if (mergedTag == null) {
                mergedTag = mp3File.getTag();
            }
            
            // 写入纯音频帧数据（自动跳过原文件的ID3头部）
            mp3File.getMp3AudioHeader().writeAudioData(outputStream);
        }

        // 若需要标签，将标签写入输出流开头
        if (mergedTag != null) {
            ByteArrayOutputStream finalOutput = new ByteArrayOutputStream();
            mergedTag.createDefaultTag().write(finalOutput);
            finalOutput.write(outputStream.toByteArray());
            return finalOutput.toByteArray();
        } else {
            return outputStream.toByteArray();
        }
    }
}

注意事项 #

• 确保所有待合并的MP3采样率、比特率、声道数一致，否则合并后可能出现卡顿、变调等问题。参数不一致的话，需要先转码统一参数再合并。
• 尽量别用Java原生的AudioInputStream直接处理MP3：原生AudioSystem对MP3支持有限，而且直接拼接AudioInputStream会保留每个文件的格式信息，导致合并后的流格式混乱。

内容的提问来源于stack exchange，提问作者mysterix