JFrame无法显示摄像头画面及退出按钮失效问题求助

问题概述 #

使用com.github.sarxos包开发二维码扫描器时出现以下问题：

• JFrame窗口弹出后仅显示空白白屏，但扫描功能正常
• 设置窗口为undecorated状态时，整个窗口直接消失
• 独立运行扫码代码正常，集成到含按钮和ActionListener的程序后失效，修改背景色无变化

核心问题分析 #

1. EDT线程阻塞：secondScreen()方法中调用scannedQRCode.get()会阻塞Swing事件调度线程（EDT），导致UI无法更新，画面空白。
2. 跨线程UI操作：在子线程中直接向JFrame添加WebcamPanel，违反Swing单线程规则，UI组件必须在EDT线程中操作才能正确渲染。
3. 窗口初始化顺序错误：先设置全屏再设置undecorated，导致窗口布局冲突，触发窗口消失问题。

修复方案 #

1. 避免EDT线程阻塞 #

移除Future.get()的阻塞调用，改用回调方式处理扫码结果，让EDT线程专注于UI更新。

2. 强制EDT线程处理UI操作 #

所有Swing组件的添加、修改操作必须通过SwingUtilities.invokeLater()在EDT线程执行。

3. 调整窗口初始化顺序 #

先设置undecorated属性，再进入全屏模式，避免布局冲突。

修改后代码示例 #

回调接口定义 #

// 定义扫码结果回调接口
interface QRCodeScanCallback {
    void onScanSuccess(String qrValue);
    void onScanError(Exception e);
}

修改secondScreen()方法 #

public void secondScreen() {
    JFrame secondScreen = new JFrame();
    secondScreen.setLayout(null);
    
    // 先设置无边框，再启动全屏
    secondScreen.setUndecorated(true);
    fullScreen(secondScreen);
    
    secondScreen.getContentPane().setBackground(Color.DARK_GRAY);
    secondScreen.setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE);

    scanQRCode scanner = new scanQRCode();
    // 使用回调处理扫码结果，避免阻塞EDT
    scanner.getQRCode(secondScreen, (int) dimensions.getWidth(), (int) dimensions.getHeight(), new QRCodeScanCallback() {
        @Override
        public void onScanSuccess(String qrValue) {
            // 扫码成功后的业务逻辑
            System.out.println("扫描到二维码：" + qrValue);
            secondScreen.dispose();
        }

        @Override
        public void onScanError(Exception e) {
            System.out.println("扫码失败：" + e.getMessage());
        }
    });

    JButton alternativeLoginButton = new JButton("或使用学生ID登录");
    alternativeLoginButton.setBounds((int) (0.5 * dimensions.getWidth() - 100),
            (int) (0.8 * dimensions.getHeight()), 200, 25);
    alternativeLoginButton.setBackground(Color.LIGHT_GRAY);
    alternativeLoginButton.setForeground(Color.BLACK);

    alternativeLoginButton.addActionListener(e -> manualStudentId(secondScreen));

    secondScreen.add(alternativeLoginButton);
    secondScreen.setAlwaysOnTop(true);
    secondScreen.setVisible(true);
}

修改scanQRCode类 #

public class scanQRCode {
    private ExecutorService executor = Executors.newSingleThreadExecutor();

    public void getQRCode(JFrame frame, int width, int height, QRCodeScanCallback callback) {
        executor.submit(() -> {
            Webcam webcam = Webcam.getDefault();
            if (webcam == null) {
                // 在EDT线程触发错误回调
                SwingUtilities.invokeLater(() -> callback.onScanError(new RuntimeException("未检测到摄像头")));
                return;
            }
            webcam.setViewSize(new java.awt.Dimension(640, 480));
            WebcamPanel webcamPanel = new WebcamPanel(webcam);
            webcamPanel.setMirrored(false);
            webcamPanel.setBounds((int) (width / 2) - 320, (int) (height / 2) - 240, 640, 480);

            // 必须在EDT线程添加UI组件
            SwingUtilities.invokeLater(() -> frame.add(webcamPanel));

            try {
                do {
                    BufferedImage image = webcam.getImage();
                    if (image == null) {
                        Thread.sleep(50); // 降低循环频率，减少CPU消耗
                        continue;
                    }
                    LuminanceSource source = new BufferedImageLuminanceSource(image);
                    BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source));
                    Result result = new MultiFormatReader().decode(bitmap);
                    if (result.getText() != null) {
                        webcam.close();
                        final String qrText = result.getText();
                        // 在EDT线程处理扫码成功逻辑
                        SwingUtilities.invokeLater(() -> {
                            frame.dispose();
                            callback.onScanSuccess(qrText);
                        });
                        break;
                    }
                    Thread.sleep(50); // 控制扫码检测频率
                } while (true);
            } catch (Exception e) {
                webcam.close();
                // 在EDT线程触发错误回调
                SwingUtilities.invokeLater(() -> callback.onScanError(e));
            }
        });
    }
}

额外优化建议 #

• 尽量避免使用setLayout(null)，改用Swing布局管理器（如BorderLayout、GridBagLayout），减少布局错位问题。
• 全屏模式下，建议通过GraphicsDevice的全屏API实现，避免窗口尺寸计算错误。
• 扫码循环中添加休眠时间，降低CPU占用率。

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