Java 播放 MIDI 音樂的高效實現：複用 Sequencer 避免內存洩漏

問題背景

Java 音頻 API (javax.sound.midi) 支援 MIDI 序列播放，但許多教程示例每次播放都 new Sequencer() 並 close()，長期運行會導致 native 內存洩漏，最終拋出 OutOfMemoryError。

核心類關係

• MidiSystem：設備管理入口，獲取 Sequencer、Sequence。
• Sequencer：播放引擎，控制啟動/停止/速度/循環；全程只需一個實例。
• Sequence：MIDI 數據容器 (音軌、事件、節奏)；可從文件/流/URL 加載，多個 Sequence 可複用同一 Sequencer。

正確模式：單 Sequencer + 多 Sequence 池

import javax.sound.midi.*;
import java.io.File;
import java.io.IOException;
import java.util.*;
import java.util.logging.*;

public class MidiPlayer implements Runnable {
    private final Sequencer sequencer;
    private final Map sequenceCache = new HashMap<>();
    private final String[] playlist;
    private volatile boolean running = true;

    public MidiPlayer(String[] midiFiles) throws MidiUnavailableException {
        this.playlist = midiFiles;
        this.sequencer = MidiSystem.getSequencer(false); // false = 不自動連接默認合成器
        this.sequencer.open();                           // 僅打開一次！
        preloadSequences();
        new Thread(this).start();
    }

    private void preloadSequences() {
        for (String name : playlist) {
            try {
                Sequence seq = MidiSystem.getSequence(new File(name));
                sequenceCache.put(name, seq);
            } catch (InvalidMidiDataException | IOException ex) {
                Logger.getLogger(MidiPlayer.class.getName()).log(Level.WARNING, "載入失敗: " + name, ex);
            }
        }
    }

    private void play(String name) {
        Sequence seq = sequenceCache.get(name);
        if (seq == null) return;
        try {
            sequencer.setSequence(seq);
            sequencer.start();
        } catch (InvalidMidiDataException ex) {
            Logger.getLogger(MidiPlayer.class.getName()).log(Level.SEVERE, "播放失敗: " + name, ex);
        }
    }

    @Override
    public void run() {
        Random rand = new Random();
        while (running) {
            String next = playlist[rand.nextInt(playlist.length)];
            System.out.println("切換曲目: " + next);
            play(next);
            try { Thread.sleep(10_000); } catch (InterruptedException ignored) { break; }
        }
        shutdown();
    }

    public void shutdown() {
        running = false;
        if (sequencer.isOpen()) sequencer.close();
        sequenceCache.clear();
    }

    public static void main(String[] args) {
        try {
            new MidiPlayer(new String[]{"1.mid","2.mid","3.mid","4.mid","5.mid"});
        } catch (MidiUnavailableException e) {
            e.printStackTrace();
        }
    }
}

關鍵點總結

1. Sequencer 單例複用：open() 後可反覆 setSequence()/start()，無需重建。
2. Sequence 預載入緩存：啟動時一次性解析文件，運行期僅切換引用，極致低延遲。
3. 資源確定性釋放：shutdown() 統一關閉 Sequencer、清空緩存，無洩漏。
4. 異常隔離：單曲載入/播放失敗不影響主循環，記錄日誌繼續下一首。

效能實測

作者測試：10ms 切換一次、連續數萬次切換，堆內存穩定不增長。證明複用模式徹底解決洩漏問題。

擴展建議

• 加入音量控制：sequencer.getTransmitter() 接入 Synthesizer 後調整 ChannelController。
• 支援播放列表循環/隨機/順序模式，封裝為 PlaylistManager。
• 整合 javax.sound.sampled 實現 MIDI + PCM 混音播放。