NetBeans开发Java Swing时背景图片运行不可见问题排查

问题场景 #

想要在MainFrame中实现：BackgroundFrame的背景图作为底层组件，LeftFrame和RightFrame分别置于左右两侧并叠加在背景图上方，但运行后背景图片无法显示。

原代码 #

MainFrame.java #

public class MainFrame extends JFrame {
    LeftFrame lf;
    RightFrame rf;
    BackgroundFrame bg;
    public MainFrame() {
        lf = new LeftFrame();
        add(lf, BorderLayout.WEST);
        rf = new RightFrame();
        add(rf, BorderLayout.EAST);
        bg = new BackgroundFrame();
        add(bg, BorderLayout.CENTER);
        setSize(5000,5000);
        setVisible(true);
        this.pack();
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    }
    public static void main(String[] args) {
        new MainFrame();
    }
}

BackgroundFrame.java #

public class BackgroundFrame extends JPanel {
ImageIcon img;
//DELETED THE SECOND PANEL
public BackgroundFrame() {
img = new ImageIcon("bg.png");
JLabel bg = new JLabel(img);
//ADDED CODE JLABEL SIZE
bg.setSize(500, 500);
add(bg);
}
}

LeftFrame.java #

public class LeftFrame extends JPanel {
public LeftFrame() {
this.setBackground(Color.WHITE);
this.setSize(100, 100);
}
}

RightFrame.java #

public class RightFrame extends JPanel {
//no code yet
}

问题原因与修复步骤 #

1. 图片路径加载错误 #

NetBeans项目中直接用"bg.png"作为相对路径，程序会从当前工作目录加载图片，而非项目资源目录。需改用类加载器加载：

img = new ImageIcon(getClass().getResource("/bg.png"));

注意：将bg.png放在项目src目录下，编译后会自动加入classpath。

2. JPanel布局导致JLabel无法填满容器 #

默认JPanel用FlowLayout，仅设置setSize无法让JLabel填满整个面板，有两种修复方式：

方案一：修改布局让JLabel自动填充

public class BackgroundFrame extends JPanel {
    ImageIcon img;
    public BackgroundFrame() {
        setLayout(new BorderLayout());
        img = new ImageIcon(getClass().getResource("/bg.png"));
        JLabel bg = new JLabel(img);
        bg.setHorizontalAlignment(JLabel.CENTER);
        add(bg, BorderLayout.CENTER);
    }
}

方案二：重写paintComponent绘制背景（更推荐）

public class BackgroundFrame extends JPanel {
    Image img;
    public BackgroundFrame() {
        img = new ImageIcon(getClass().getResource("/bg.png")).getImage();
        setOpaque(false);
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        g.drawImage(img, 0, 0, getWidth(), getHeight(), this);
    }
}

3. 窗口初始化顺序错误 #

原代码先调用setVisible(true)再执行pack()，会导致布局计算异常，调整顺序：

public MainFrame() {
    lf = new LeftFrame();
    add(lf, BorderLayout.WEST);
    rf = new RightFrame();
    add(rf, BorderLayout.EAST);
    bg = new BackgroundFrame();
    add(bg, BorderLayout.CENTER);
    
    setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    pack();
    setVisible(true);
}

4. 左右面板透明度设置 #

若希望背景图透过左右面板显示，需设置面板透明：

// LeftFrame构造方法添加
this.setOpaque(false);
// RightFrame构造方法添加
this.setOpaque(false);

最终效果 #

修改后，BackgroundFrame的背景图会填满窗口中心区域作为底层，LeftFrame和RightFrame在左右两侧叠加其上（设置透明后可透过面板看到背景图）。

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