JavaFX MediaPlayer 加载本地视频失败，黑屏或报 MediaException
根本原因通常是路径没对、格式不支持，或者 JavaFX 媒体后端没加载成功。JavaFX 默认只支持 MP4（H.264 + AAC）、MPEG-2 和某些 AVI 容器，但实际依赖系统原生解码器（Windows 用 Media Foundation，macOS 用 AVFoundation），Linux 支持最弱。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先用绝对路径测试，比如
new File("C:/test/video.mp4").toURI().toString()，避免相对路径解析歧义 - 确保文件扩展名和 MIME 类型匹配：MP4 文件必须是
.mp4后缀，不能是.MP4或无后缀 - 在构造
Media前加 try-catch，打印完整异常：e.printStackTrace()—— 常见错误如MediaException: ERROR_MEDIA_UNSUPPORTED就说明编码不兼容 - Linux 用户需确认安装了
gstreamer1.0-plugins-bad和gstreamer1.0-libav（Ubuntu/Debian）
为什么 MediaPlayer 播放不了网络视频（HTTP/HTTPS URL）
JavaFX 11+ 默认禁用非本地协议的媒体加载，且不走标准 HTTP 客户端，无法自动处理重定向、认证或自定义 Header。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 本地开发可临时启用：
System.setProperty("prism.allowhidpi", "true");不起作用；真正要设的是 JVM 参数：-Dprism.allowhidpi=true—— 但这和网络播放无关；正确做法是改用本地代理或预下载 - 更可靠的方式：先用
HttpClient下载到临时文件，再用file://路径加载 - HTTPS 视频若证书异常（如自签名），
MediaPlayer不会提示 SSL 错误，只会静默失败 —— 必须提前验证 URL 可访问 - 不要传带查询参数的 URL（如
video.mp4?t=123），部分平台会截断或拒绝解析
MediaView 显示区域拉伸变形、黑边或尺寸错乱
这是最常见的 UI 同步问题：MediaView 不自动响应父容器尺寸变化，也不默认保持宽高比。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 手动绑定宽高：
mediaView.fitWidthProperty().bind(parent.widthProperty());和fitHeightProperty().bind(parent.heightProperty())，但会导致变形 - 保持比例的关键是只绑一个方向，并设
mediaView.setPreserveRatio(true)；否则即使尺寸变，画面也会被强行拉伸 - 如果父容器是
BorderPane或VBox，记得调用setAutoSizeChildren(true)（仅适用于某些布局） - 首次显示前，确保
MediaPlayer状态为READY再设置MediaView的setMediaPlayer()，否则尺寸计算可能为 0
播放控制卡顿、暂停后无法恢复，或 seek() 失效
MediaPlayer 的状态机很敏感，很多操作必须在特定状态下调用，否则被忽略或抛异常。
实操建议：
立即学习“Java免费学习笔记（深入）”；
-
seek()只在PLAYING或PAUSED状态下有效；如果还在READY或刚STOP，得先play()再pause()才能 seek - 频繁调用
stop()+play()容易导致状态不同步，推荐统一用pause()/play()切换 - 监听状态变更用
mediaPlayer.setOnPlaying()等回调，别轮询getStatus()—— 它返回的是快照，不是实时值 - 音视频不同步时，
MediaPlayer不提供手动补偿 API；唯一可控的是关闭音频：mediaPlayer.setMute(true)，再单独处理视频帧（需进阶方案）
JavaFX 媒体栈底层耦合系统组件，跨平台行为差异大。最稳的做法是：所有路径走本地文件 + 预检查格式 + 绑定状态回调做防御性判断。别指望它像 Web API 那样宽容。
