Java如何将音频流保存为文件 Java将PCM数据写入WAV文件方法【详解】_技术教程

WAV文件必须补全44字节RIFF头和fmt子块，PCM数据需严格匹配AudioFormat参数（采样率、位深、声道数、小端序），subChunk2Size须等于PCM字节数并确保偶数对齐，否则播放器无法识别。

PCM数据写入WAV文件前必须补全RIFF头和fmt子块

WAV不是裸PCM容器，直接把byte[]写进文件会导致播放器无法识别。必须手动构造WAV文件头：44字节标准头（含"RIFF"、"WAVE"、"fmt "、"data"等标识），否则用AudioSystem.write()会失败或生成损坏文件。

AudioFormat中采样率、位深、声道数必须与实际PCM数据严格一致，否则头里写的avgBytesPerSec和subChunk2Size会错位
16位PCM需按小端序（little-endian）排列，Java默认DataOutputStream是大端，得用ByteBuffer.order(ByteOrder.LITTLE_ENDIAN)
单声道、双声道的frameSize不同（如16bit单声道=2字节/帧，双声道=4字节/帧），影响subChunk2Size计算

用AudioSystem.write()写WAV最简但限制多

如果已有AudioInputStream，AudioSystem.write()能自动补头，但前提是输入流的AudioFormat必须被JDK原生支持（如LINEAR、PCM、ALAW、ULAW）。常见踩坑点：

传入AudioFormat时设encoding = AudioFormat.Encoding.PCM_SIGNED，不能用PCM_UNSIGNED（JDK不支持）
采样率必须是整数，且推荐用44100、48000、16000等常见值；用44100.5会抛IllegalArgumentException
位深必须是8、16、24、32之一；传20会静默转成16，导致数据截断
文件后缀必须为".wav"，用".WAV"在Windows下可能失败

AudioFormat format = new AudioFormat(
    AudioFormat.Encoding.PCM_SIGNED,
    44100.0f, // sampleRate
    16,       // sampleSizeInBits
    2,        // channels
    4,        // frameSize (2 bytes × 2 channels)
    44100.0f, // frameRate
    false     // bigEndian → false for little-endian
);
ByteArrayInputStream bais = new ByteArrayInputStream(pcmBytes);
AudioInputStream ais = new AudioInputStream(bais, format, pcmBytes.length / format.getFrameSize());
AudioSystem.write(ais, AudioFileFormat.Type.WAVE, new File("out.wav"));

手动写WAV头更可控，适合非标准PCM场景

当PCM来自硬件采集、网络流或自定义编码（如带静音头、非对齐buffer），必须手写头。关键字段要动态算：

ChunkSize = 36 + subChunk2Size（36是头固定长度，subChunk2Size = pcmBytes.length）
SubChunk2Size必须等于原始PCM字节数，多1字节都会让播放器解码错位
16位双声道PCM，每帧4字节，若pcmBytes.length不是4的倍数，需在末尾补0（否则frameSize校验失败）
写完头再写PCM数据，顺序不能颠倒；用FileOutputStream配合DataOutputStream逐字段写

DataOutputStream dos = new DataOutputStream(new FileOutputStream("out.wav"));
// RIFF header
dos.writeBytes("RIFF");
dos.writeInt(36 + pcmBytes.length); // ChunkSize
dos.writeBytes("WAVE");
// fmt subchunk
dos.writeBytes("fmt ");
dos.writeInt(16); // SubChunk1Size
dos.writeShort((short) 1); // AudioFormat (1 = PCM)
dos.writeShort((short) channels);
dos.writeInt((int) sampleRate);
dos.writeInt((int) (sampleRate * channels * bitsPerSample / 8)); // byteRate
dos.writeShort((short) (channels * bitsPerSample / 8)); // blockAlign
dos.writeShort((short) bitsPerSample);
// data subchunk
dos.writeBytes("data");
dos.writeInt(pcmBytes.length);
dos.write(pcmBytes);
dos.close();

注意字节序、padding和异常边界

真实项目里最容易漏的是字节对齐和异常处理：

WAV规范要求data子块大小必须是偶数，若pcmBytes.length为奇数，得在末尾补1个0x00字节，并同步更新SubChunk2Size和ChunkSize
写磁盘时没加try-with-resources或close()，会导致文件句柄泄露，多次调用后FileNotFoundException报“Access is denied”
从麦克风实时采集PCM时，buffer可能含静音帧或未填满部分，直接写入会导致杂音，应先用Arrays.copyOfRange()截取有效长度
Android上AudioRecord返回的PCM默认是小端，但某些芯片（如部分高通平台）可能反直觉地返回大端，需实测验证