IntelliJ中Swing GUI无法获取JPanel，抛出contentPane为空异常

问题原因 #

IntelliJ的Swing GUI Form设计器依赖自动生成的initComponents()方法初始化所有UI组件（包括你的mainPanel）。你的代码中未调用该方法，导致mainPanel始终为null，调用setContentPane(mainPanel)时触发IllegalComponentStateException。

解决方案 #

1. 在构造函数中添加initComponents()调用 #

修改构造函数，先执行组件初始化，再配置窗口：

public class Test extends JFrame { // 修正类名首字母大写，符合Java规范
    private JPanel mainPanel;

    public Test(){
        super("Flight Details");
        initComponents(); // 关键：添加此行初始化Form组件

        this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        this.setContentPane(mainPanel);
        this.pack();
        this.setSize(1000, 800);
    }

    // 此方法由IntelliJ自动生成，无需手动编写
    private void initComponents() {
        // 自动生成的组件初始化代码，会实例化mainPanel并配置其属性
    }

    public static void main(String[] args) {
        JFrame frame = new Test();
        frame.setVisible(true);
    }
}

2. 确认Form与Java类的关联 #

若调用initComponents()后仍有问题，检查IntelliJ中的绑定：

• 右键Test.java文件，选择Form > Associate with Form
• 在弹窗中选择对应的test.form文件，确保mainPanel的变量名在Form设计器和Java代码中完全一致（注意大小写）

3. 额外优化建议 #

• 移除setLayout(new BorderLayout())：JFrame默认contentPane已使用BorderLayout，替换为mainPanel后该设置无效
• 优先使用pack()而非手动setSize()：pack()会根据组件自动调整窗口大小，更符合Swing规范

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