JavaFX集成VLCJ播放器：视频几秒后冻结但音频正常，GC优化无效

场景与代码 #

我基于VLCJ开发JavaFX媒体播放器，其中DMediaPlayer.java负责创建VLCJ媒体播放器实例，并返回用于视频显示的ImageView；PlayerView.java作为UI容器负责展示视频，核心代码如下：

public class PlayerView extends BorderPane {

    private MenuBar menuBar;
    private VideoControlPanel controlPanel;
    private Drawer drawer;

    private IconsProvider icons;
    private MediaPlayerInterface mediaPlayer;
    private ImageView mediaView;
    private StackPane playerHolder;
    private ImageView view;


    public PlayerView() {
        view = new ImageView();
        icons = new IconsProvider();
        menuBar = new MenuBar(icons);
        setTop(menuBar);

        playerHolder = new StackPane();
        playerHolder.setAlignment(Pos.TOP_LEFT);
        setCenter(playerHolder);


        mediaPlayer = new DMediaPlayer();
        mediaView = mediaPlayer.getMediaView();
        playerHolder.getChildren().add(mediaView);
        try {
            mediaPlayer.load("/home/doruk/Downloads/Video/movie.mkv");
        } catch (FileNotFoundException e) {
            System.out.println(e.toString());
        }

        mediaPlayer.play();

        playerHolder.getChildren().add(drawer);
    }
}

问题现象 #

视频初始播放正常，但几秒后ImageView定格在单帧（类似暂停状态），但音频仍持续播放。

前期尝试与错误 #

最初猜测是ImageView被垃圾回收（GC）导致，因为直接执行以下代码时会触发明确的GC相关错误：

DMediaPlayer player = new DMediaPlayer()
player.play()

错误日志：

JNA: callback object has been garbage collected
JNA: callback object has been garbage collected
JNA: callback object has been garbage collected
malloc(): unaligned tcache chunk detected

因此改为在PlayerView中创建ImageView并传递给DMediaPlayer，但问题依旧。

解决方案 #

核心原因 #

问题本质不是ImageView被回收，而是VLCJ内部负责视频帧渲染的回调/桥接对象（比如JavaFxVideoSurface关联的底层对象）失去了强引用，被GC清理后导致视频渲染中断，而音频流不受影响。

具体修复步骤 #

1. 强持有VLCJ核心渲染对象
   在DMediaPlayer类中，必须将MediaPlayer、JavaFxVideoSurface等核心对象声明为类成员变量，避免作为局部变量被GC回收。示例实现：

   public class DMediaPlayer implements MediaPlayerInterface {
       // 声明为类成员，保持强引用
       private final MediaPlayer mediaPlayer;
       private final JavaFxVideoSurface videoSurface;
       private final ImageView mediaView;
   
       public DMediaPlayer() {
           MediaPlayerFactory factory = new MediaPlayerFactory();
           mediaPlayer = factory.mediaPlayer();
           
           // 创建JavaFX视频表面并关联ImageView
           videoSurface = JavaFxVideoSurface.videoSurface();
           mediaView = videoSurface.getImageView();
           
           // 将视频表面绑定到播放器
           mediaPlayer.videoSurface().set(videoSurface);
       }
   
       @Override
       public ImageView getMediaView() {
           return mediaView;
       }
   
       // 实现load方法
       public void load(String path) throws FileNotFoundException {
           File mediaFile = new File(path);
           if (!mediaFile.exists()) {
               throw new FileNotFoundException("Media file not found: " + path);
           }
           mediaPlayer.media().play(mediaFile.getAbsolutePath());
       }
   
       // 实现play方法
       public void play() {
           mediaPlayer.controls().play();
       }
   }
   

2. 确保PlayerView持有DMediaPlayer的强引用
   现有代码已经将mediaPlayer作为PlayerView的类成员，这部分没问题，但要避免在运行时将其置为null，或破坏其引用链。

3. 修复未初始化的drawer对象
   原代码中drawer未完成初始化就添加到playerHolder，可能导致布局异常间接影响渲染。需要先执行drawer = new Drawer();，再添加到容器中。

4. 验证GC触发时机（可选）
   添加JVM启动参数-XX:+PrintGCDetails -XX:+PrintGCTimeStamps，查看视频卡顿是否与GC执行时间重合，进一步确认是否为GC回收导致的问题。

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