Spring Boot项目Linux下JLayer转MP3为WAV失败但macOS正常如何解决

1 优先排查文件名大小写敏感问题 #

Linux文件系统默认大小写敏感，macOS默认大小写不敏感。你当前代码判断MP3后缀用的是fileName.contains(".mp3")，如果上传的文件后缀是.MP3（大写），Linux环境下会直接跳过转换逻辑，macOS下因为文件系统大小写不敏感不会出现该问题。
修复方案：把后缀判断统一转成小写再匹配：

if (fileName.toLowerCase().contains(".mp3"))

2 检查目录读写权限 #

Linux环境下Spring Boot应用的运行用户（比如systemd启动的默认用户、tomcat用户等）通常权限受限，如果你配置的songPath目录对应用户没有读写权限，会导致转换后的文件写入失败，且你当前的异常捕获逻辑会漏掉这类IO异常。
临时验证方案：给songPath对应目录开放全局读写权限测试：

chmod -R 777 你的songPath绝对路径

验证成功后再将目录所有者修改为应用运行用户即可恢复安全权限：

chown -R 应用运行用户:用户组 你的songPath绝对路径

3 修复异常捕获与路径拼接逻辑 #

你当前convertToWav方法仅捕获了JavaLayerException，权限异常、路径不合法、依赖类缺失等非该类型的异常都会直接抛出，且没有完整异常栈打印，很难定位问题；同时硬编码/作为路径分隔符也可能出现路径匹配问题。
优化后的convertToWav方法参考：

private void convertToWav(String fileName) {
    try {
        String lowerFileName = fileName.toLowerCase();
        if (lowerFileName.contains(".mp3")) {
            Converter converter = new Converter();
            // 用Path拼接避免硬编码分隔符问题
            Path outputPath = Paths.get(songPath).resolve("song.wav");
            // 打印路径方便排查
            logger.info("开始转换MP3，输入路径：{}，输出路径：{}", fileName, outputPath);
            converter.convert(fileName, outputPath.toString());
            logger.info("MP3转换完成，输出文件大小：{}字节", Files.size(outputPath));
        } else if (lowerFileName.contains(".wav")) {
            logger.info("文件为WAV格式，无需转换");
        }
    } catch (Exception e) { // 捕获所有异常避免漏报错
        logger.error("转换文件失败，输入路径：{}", fileName, e); // 打印完整异常栈
    }
}

同时建议你在saveSong方法里也把songPath的绝对路径打印出来，确认Linux环境下的路径和你预期一致。

4 检查打包依赖完整性 #

确认你部署到Linux的Jar包是完整的可执行Jar，包含了JLayer的全部依赖，避免因为类缺失导致转换逻辑初始化失败。你可以在本地用java -jar命令跑同一个Jar包验证功能正常后再部署到Linux。

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