MacOS 10.13.4下JavaFX MediaPlayer无声音问题求助

I'm having an issue where my JavaFX MediaPlayer works perfectly on Windows 10, but produces no sound at all on my MacBook Air running macOS 10.13.4 (17E202). I've identified this is related to garbage collection (GC) after looking into similar issues.

I've tried all the common workarounds suggested for GC-related MediaPlayer issues:

• Marking the MediaPlayer as final, static, private, or public
• Using getters/setters to access it
• Moving its handling to a separate class
• Declaring it as a class variable (as shown in my code) or a local variable

None of these fixes have worked for me. I'm using Java 9.0.4.

If I add player.setCycleCount(MediaPlayer.INDEFINITE);, the sound plays but loops indefinitely. Setting the cycle count to 2 works for playback, but breaks my next/back/play/pause button functionality. I cannot use AudioClip as a replacement — I must use MediaPlayer.

Here's my minimal reproducible code:

public class Main extends Application {
    MediaPlayer player;

    @Override
    public void start(Stage primaryStage) throws Exception {
        BorderPane root = new BorderPane();
        File file = new File("/users/xxx/desktop/xxx/Song.mp3");
        Media media = new Media(file.toURI().toString());
        this.player = new MediaPlayer(media);
        player.play();

        primaryStage.setScene(new Scene(root, 600, 400));
        primaryStage.show();
    }
}

Solution #

Hey there, let's work through this macOS-specific MediaPlayer sound issue. I've dealt with similar GC-related quirks on older macOS versions, so here are some targeted fixes to try:

1. Explicitly Keep a Strong Reference & Force Media Initialization

On macOS, the MediaPlayer sometimes fails to fully initialize before GC sweeps related resources. Try adding a pre-load call and anchoring the player to the scene graph to keep it alive:

@Override
public void start(Stage primaryStage) throws Exception {
    BorderPane root = new BorderPane();
    File file = new File("/users/xxx/desktop/xxx/Song.mp3");
    Media media = new Media(file.toURI().toString());
    this.player = new MediaPlayer(media);
    
    // Wait for media to be ready before playing
    player.setOnReady(() -> {
        player.play();
    });
    // Attach player to the scene graph to prevent GC from collecting it
    root.setUserData(player);

    primaryStage.setScene(new Scene(root, 600, 400));
    primaryStage.show();
}

Attaching the player to the scene graph via setUserData gives the JVM a concrete reason to retain the reference, which often resolves silent playback.

2. Adjust VM Arguments for GC (Java 9 Specific)

Java 9 introduced GC tweaks that can cause unexpected behavior on older macOS releases. Add these VM arguments when launching your app:

-XX:+UseParallelGC -Xmx512m

This forces a more predictable GC strategy that's less likely to prematurely collect MediaPlayer resources.

3. Verify macOS Sound Settings & Permissions

Don't overlook the basics:

• Double-check that your MacBook's sound isn't muted, and the correct output device is selected in System Preferences > Sound
• For macOS 10.13+, Java apps sometimes need explicit audio permissions. Go to System Preferences > Security & Privacy > Privacy > Microphone (yes, even for playback) and ensure your Java runtime is enabled. It sounds odd, but this has fixed silent playback for many users.

4. Use a Singleton Wrapper for Persistent Reference

If class-level references aren't enough, a singleton wrapper ensures a single, persistent reference to the MediaPlayer throughout your app's lifecycle:

public class MediaPlayerManager {
    private static MediaPlayerManager instance;
    private MediaPlayer player;

    private MediaPlayerManager() {}

    public static MediaPlayerManager getInstance() {
        if (instance == null) {
            instance = new MediaPlayerManager();
        }
        return instance;
    }

    public void setPlayer(MediaPlayer player) {
        this.player = player;
    }

    public MediaPlayer getPlayer() {
        return player;
    }
}

Then update your start method to use the singleton:

Media media = new Media(file.toURI().toString());
MediaPlayer player = new MediaPlayer(media);
MediaPlayerManager.getInstance().setPlayer(player);
player.setOnReady(() -> player.play());

One final note: Java 9 is quite outdated. If possible, upgrading to Java 11 (LTS) would give you better macOS compatibility and fix many JavaFX bugs from the Java 9 era. But if upgrading isn't an option, the above fixes should get your MediaPlayer working properly.

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