JavaFX MediaPlayer播放本地文件需用Paths.get().toUri()转合法file:// URI；须监听onError和onReady事件避免卡死；Slider需手动绑定seek且归一化；JAR内资源须解压到临时目录再播放。
JavaFX MediaPlayer 播放本地文件失败：路径不对或协议缺失
直接用 MediaPlayer 加载 "./music/song.mp3" 会报 MediaException: MEDIA_UNAVAILABLE，不是文件不存在，而是 JavaFX 要求路径必须是合法 URI（带协议）。相对路径、Windows 的 C:\xxx 都不被接受。
- 正确做法：用
Paths.get("path").toUri().toString()转成file:///C:/xxx或file:///Users/xxx格式 - Windows 下别手写
file://C:\...—— 反斜杠和单斜杠混用会解析失败；统一用toUri() - 如果路径含中文或空格，
toUri()会自动编码，不用手动URLEncoder.encode()
示例：
String uri = Paths.get("music/demo.mp3").toUri().toString();
Media media = new Media(uri);
MediaPlayer player = new MediaPlayer(media);
JavaFX 界面卡死：MediaPlayer 在主线程调用 play() 但没做异常兜底
MediaPlayer 启动时若媒体格式不支持（比如系统缺解码器）、文件损坏、权限不足，会静默失败或抛未检查异常，导致后续按钮无响应、进度条不动——表面看是“卡”，实则是播放器状态卡在 UNKNOWN 或 HALTED。
- 务必监听
player.setOnError()，并在回调里打印player.getError() - 不要只靠
player.getStatus() == Status.READY判断是否可播；要等player.setOnReady()回调触发后再调play() - 避免在
setOnReady里直接调play()后立刻设音量/循环——有些系统下状态切换有微小延迟，建议加个Platform.runLater()包一层
进度条拖动不准 + 播放跳变：没有同步 MediaView 和 MediaPlayer 的时间轴
把 Slider 绑定到 MediaPlayer.getCurrentTime() 不行——这个值是只读的，拖动 Slider 不会自动 seek。必须手动监听 Slider 变化并调 player.seek()，但直接调容易因单位不一致跳错位置。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
MediaPlayer的currentTime是Duration类型，单位是秒（含毫秒），而 Slider 的 value 通常是 0–100 的 double - 绑定逻辑应为：
slider.valueProperty().addListener((_, _, v) -> player.seek(new Duration(v.doubleValue() * player.getTotalDuration().toSeconds())); - 反过来，播放中更新 Slider 要监听
player.currentTimeProperty()，并把Duration.toSeconds()归一化到 0–100 - 注意：首次加载时
getTotalDuration()可能返回Duration.UNKNOWN，需等onReady后再初始化 Slider 最大值
打包后双击 JAR 找不到音乐文件：getResource() 和 file 协议混用
开发时用 Paths.get("music/xxx.mp3") 能跑，但打成 JAR 后路径失效——因为资源被打包进 JAR，不再是文件系统路径，toUri() 会生成 jar:file:///xxx.jar!/music/xxx.mp3，而 MediaPlayer 不支持 jar: 协议。
立即学习“Java免费学习笔记（深入）”；
- 解决办法只有两个：① 把音乐文件放在 JAR 外（如程序同级
./res/music/），保持用file://；② 运行时解压资源到临时目录，再传临时路径给MediaPlayer - 别用
getClass().getResource("/music/xxx.mp3")得到 URL 再转 URI——它返回的是jar:...，直接喂给Media构造器会静默失败 - 如果坚持资源内嵌，必须先用
IOUtils.copy(getClass().getResourceAsStream(...), tempFile)提取，否则免谈
真正麻烦的不是代码怎么写，而是得想清楚：你的用户愿不愿意额外放一个 music 文件夹？要不要支持拖入任意本地文件？这些决定直接影响路径策略和错误提示方式。
