Android Studio中MIDI文件保存异常：无法在Windows标准播放器打开

场景：在Android应用中读取MIDI文件并写入内部存储后，生成的文件可在MuseScore打开但Windows标准播放器无法打开；对比原文件与生成文件，发现几处字节差异，且相同代码在IntelliJ IDEA桌面环境运行正常。
代码片段：

try {
    midiFile = new MidiFile(file);
    midiFile.writeToFile(new File("/storage/emulated/0/download/file.mid"));
} catch (IOException e) {
    Log.d("midifile", "open failed");
}

差异字节位置（假设从0开始计数）：

• 位置22：原0x4A（74）→ 现0x48（72）
• 位置1182：原0x27（39）→ 现0x26（38）
• 位置5441：原0x67（103）→ 现0x65（101）
• 位置10276：原0x68（104）→ 现0x67（103）

可能的原因 #

• MIDI库跨平台实现差异
  你使用的MidiFile类（大概率是第三方库）在Android和桌面JVM上的解析/编码逻辑不一致，尤其是在处理MIDI文件的变量长度数量（VLQ）、轨道事件时间戳或元数据时，出现了细微的计算偏差。这些偏差刚好触发了Windows播放器的严格兼容性校验，但MuseScore的解析器对格式容错性更高。

• 二进制文件IO处理错误
  如果writeToFile方法在Android平台下误用了字符流而非字节流来写入二进制MIDI数据，可能会导致部分字节被错误转换（比如换行符、编码转换），而桌面环境的IO处理逻辑更严谨，避免了这个问题。

• Windows播放器的格式兼容性限制
  Windows标准播放器（如Windows Media Player）仅支持MIDI 1.0的特定子集，对轨道结构、时间分辨率或元事件的格式要求更苛刻。生成的文件虽然符合MIDI核心规范，但某些细节不符合Windows播放器的私有校验规则。

排查与解决步骤 #

1. 直接复制原文件字节测试
   绕过MidiFile库的解析重写逻辑，直接用字节流复制原文件到目标路径，验证是否能被Windows播放器打开：

   try (InputStream is = new FileInputStream(file);
        OutputStream os = new FileOutputStream("/storage/emulated/0/download/file.mid")) {
       byte[] buffer = new byte[4096];
       int bytesRead;
       while ((bytesRead = is.read(buffer)) != -1) {
           os.write(buffer, 0, bytesRead);
       }
   } catch (IOException e) {
       Log.d("midifile", "copy failed: " + e.getMessage());
   }
   

   如果复制后的文件能正常打开，说明问题完全出在MidiFile库的处理逻辑上。

2. 检查MIDI库的IO实现
   查看MidiFile.writeToFile的源码，确认其在Android平台下是否使用FileOutputStream等字节流进行写入，而非FileWriter等字符流。如果是字符流导致的问题，修改库代码或替换为字节流写入逻辑。

3. 分析差异字节的MIDI格式含义
   结合MIDI文件格式规范，定位差异字节对应的字段：

   • 位置22通常处于第一个轨道（MTrk块）的事件区域，差异可能是事件时间戳的VLQ编码错误；
   • 其他位置的差异均为数值减1/减2，大概率是VLQ计算时的溢出或逻辑错误导致。
     可以用MIDI文件分析工具（如MidiView）对比原文件和生成文件的轨道事件结构，确认具体差异点。

4. 更换或更新MIDI库
   如果确认是库的跨平台问题，尝试更新到该库的最新版本，或更换更成熟的Android适配MIDI库（如基于Android MIDI API的实现）。

5. 验证Windows播放器的兼容要求
   对比原文件与生成文件的MIDI头信息（MThd块）：格式类型、轨道数、时间分辨率，确保生成文件的这些字段与原文件完全一致，避免因头信息差异导致Windows播放器拒绝解析。

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