Java Swing GUI中图片无法显示问题求助（附启动屏代码）

Hey there! Let's break down why your splash screen image isn't showing up and fix it step by step.

Common Issues & Fixes #

1. Silent Network Image Loading Failures #

When using a remote URL to load an image with ImageIcon, it won’t throw an error if the image fails to load (e.g., network timeouts, broken links, or access restrictions). Instead, it just displays a blank label—super frustrating!

Fixes:

• Verify the image URL: First, confirm the link works directly in your browser. If this is a desktop app, it’s way more reliable to load the image from your project’s classpath instead of a remote source:

  // Load from src/main/resources (adjust the path to match your project structure)
  ImageIcon image = new ImageIcon(getClass().getResource("/Wt9kOSU.png"));
  

• Check load status: Add a quick check to confirm the image loaded successfully:

  Image img = image.getImage();
  if (img.getWidth(null) == -1) {
      System.err.println("Oops, failed to load the splash image!");
      return;
  }
  

2. Blocking the Swing Event Dispatch Thread (EDT) #

Calling Thread.sleep(5000) in the same thread that creates your Swing components blocks the EDT—the thread responsible for rendering UI elements. This can prevent the image from drawing before the sleep kicks in.

Fix: Use SwingUtilities.invokeLater to run UI code on the EDT, and replace Thread.sleep with a Timer to close the window after the delay:

private void splashScreen() {
    SwingUtilities.invokeLater(() -> {
        JWindow window = new JWindow();
        // Use a classpath resource or verified remote URL here
        ImageIcon image = new ImageIcon(getClass().getResource("/Wt9kOSU.png"));
        JLabel imageLabel = new JLabel(image);
        window.add(imageLabel);
        window.pack();
        window.setLocationRelativeTo(null); // Center the window on screen
        window.setVisible(true);

        // Auto-close after 5 seconds without blocking the EDT
        new Timer(5000, e -> {
            window.setVisible(false);
            window.dispose();
        }).start();
    });
}

3. Waiting for the Image to Fully Load #

Even with a valid URL, the image might not finish loading before the window is shown. Use MediaTracker to ensure the image is ready before displaying the window:

private void splashScreen() throws InterruptedException {
    JWindow window = new JWindow();
    ImageIcon image = new ImageIcon(new URL("https://i.imgur.com/Wt9kOSU.png"));
    Image img = image.getImage();

    // Wait for the image to load completely
    MediaTracker tracker = new MediaTracker(window);
    tracker.addImage(img, 0);
    tracker.waitForAll();

    // Check if any loading errors occurred
    if (tracker.isErrorAny()) {
        System.err.println("Image loading failed—check your URL or network!");
        return;
    }

    JLabel imageLabel = new JLabel(image);
    window.add(imageLabel);
    window.pack();
    window.setLocationRelativeTo(null);
    window.setVisible(true);

    // Use a Timer to close the window gracefully
    new Timer(5000, e -> {
        window.setVisible(false);
        window.dispose();
    }).start();
}

Final Quick Tips #

• Always run Swing UI code on the EDT with SwingUtilities.invokeLater to avoid weird rendering glitches.
• Stick to local classpath resources for splash screens—they’re faster and don’t depend on network availability.

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