Swing叠加面板鼠标事件冲突问题求解

你的问题核心是叠加层面板拦截了鼠标事件，导致下层组件无法接收mouseEntered/mouseExited这类依赖边界检测的事件。下面提供两种直接有效的解决思路：

方法一：设置鼠标透明+父容器监听鼠标位置 #

让叠加层不拦截任何鼠标事件，同时在父容器上监听鼠标移动来更新叠加层的绘制坐标：

1. 给LinePanel添加setMouseTransparent(true)，让它完全不接收鼠标事件，事件会直接穿透到下层组件；
2. 将鼠标移动的监听逻辑从LinePanel内部移到父容器JLayeredPane上，通过方法调用更新叠加层的鼠标位置。

修改后的完整代码：

import javax.swing.Box;
import javax.swing.BoxLayout;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLayeredPane;
import javax.swing.JPanel;
import javax.swing.event.MouseInputAdapter;

import java.awt.Color;
import java.awt.Graphics;
import java.awt.event.ComponentAdapter;
import java.awt.event.ComponentEvent;
import java.awt.event.MouseEvent;
import java.awt.event.MouseMotionListener;

public class MWE extends JFrame
{

    public class LinePanel extends JPanel
    {
        int mouseX;
        int mouseY;
        
        public LinePanel()
        {
            mouseX = 100;
            mouseY = 100;
            this.setOpaque(false);
            this.setLayout(null);
            // 设置鼠标透明，不拦截任何鼠标事件
            this.setMouseTransparent(true);
        }

        @Override
        public void paint(Graphics g) {
            super.paint(g);
            g.drawOval(mouseX - 10, mouseY  - 10, 20, 20);
        }
        
        // 提供外部更新鼠标位置的方法
        public void updateMousePos(int x, int y) {
            this.mouseX = x;
            this.mouseY = y;
            repaint();
        }
    }

    public MWE()
    {
        JLayeredPane layeredPane = new JLayeredPane();

        JPanel buttonPanel = new JPanel();
        buttonPanel.setLayout(new BoxLayout(buttonPanel, BoxLayout.PAGE_AXIS));
        
        JButton button = new JButton("Foo");
        button.addMouseListener(new MouseInputAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                button.setBackground(Color.red);
            }

            @Override
            public void mouseExited(MouseEvent e) {
                button.setBackground(null);
            }
        });

        button.setAlignmentX(JButton.CENTER_ALIGNMENT);

        buttonPanel.add(Box.createVerticalGlue());
        buttonPanel.add(button);
        buttonPanel.add(Box.createVerticalGlue());

        LinePanel linePanel = new LinePanel();

        // 在父容器上监听鼠标移动，更新叠加层位置
        layeredPane.addMouseMotionListener(new MouseMotionListener() {
            @Override
            public void mouseMoved(MouseEvent e) {
                linePanel.updateMousePos(e.getX(), e.getY());
            }

            @Override
            public void mouseDragged(MouseEvent e) {}
        });

        layeredPane.add(buttonPanel, Integer.valueOf(0));
        layeredPane.add(linePanel, Integer.valueOf(1));

        layeredPane.addComponentListener(new ComponentAdapter() {
            @Override
            public void componentResized(ComponentEvent e) {
                buttonPanel.setBounds(layeredPane.getBounds());
                linePanel.setBounds(layeredPane.getBounds());
                buttonPanel.revalidate();
            }
        });

        this.setContentPane(layeredPane);
        this.setDefaultCloseOperation(EXIT_ON_CLOSE);
        this.setSize(400, 300); // 设置初始窗口大小
    }
    
    public static void main(String[] args)
    {
        MWE frame = new MWE();
        frame.setVisible(true);
    }
}

方法二：重写contains方法实现事件穿透 #

通过重写LinePanel的contains方法，让Swing认为鼠标不在该组件上，从而将事件传递给下层组件：

1. 重写LinePanel的contains(int x, int y)方法，返回false；
2. 同样在父容器监听鼠标移动，更新叠加层的绘制坐标。

修改LinePanel的核心代码：

public class LinePanel extends JPanel
{
    int mouseX;
    int mouseY;
    
    public LinePanel()
    {
        mouseX = 100;
        mouseY = 100;
        this.setOpaque(false);
        this.setLayout(null);
    }

    @Override
    public void paint(Graphics g) {
        super.paint(g);
        g.drawOval(mouseX - 10, mouseY  - 10, 20, 20);
    }
    
    // 重写contains方法，让组件不"捕获"鼠标位置
    @Override
    public boolean contains(int x, int y) {
        return false;
    }
    
    public void updateMousePos(int x, int y) {
        this.mouseX = x;
        this.mouseY = y;
        repaint();
    }
}

为什么dispatchEvent无法触发mouseEntered/mouseExited？ #

这两个事件是Swing根据鼠标进入/离开组件边界的系统级检测自动派发的，手动调用dispatchEvent无法模拟这种边界检测逻辑，因此无法触发这类事件。上面的两种方法从事件派发的根源解决问题，让下层组件能正常接收系统原生的鼠标事件。

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