PyQt5中QGraphicsRectItem设置地图图片时程序崩溃问题

嘿，我来帮你排查这个无报错崩溃的问题！从你给出的代码片段来看，核心问题大概率出在QGraphicsRectItem的使用方式以及图片资源的处理上——毕竟QGraphicsRectItem本身是用来绘制矩形图形的，不是专门的图片显示项，直接在里面塞图片很容易触发内存或绘制逻辑的隐性问题。下面是具体的分析和修复方案：

可能的崩溃原因 #

• 控件选型错误：QGraphicsRectItem的设计初衷是绘制矩形边框/填充，并非承载图片。如果强行在它内部处理图片，很容易和默认的绘制逻辑冲突，引发无报错崩溃。
• 图片生命周期丢失：如果转换后的图片资源（比如QPixmap）是局部变量，会被Python的垃圾回收机制回收，绘制时引用失效就会导致程序崩溃，这种情况通常不会抛出显性错误。
• 未实现正确的绘制逻辑：如果没有重写paint方法，QGraphicsRectItem只会绘制默认矩形，你添加的图片根本不会被渲染，甚至可能因为非法内存访问触发崩溃。

修复后的完整代码 #

这里提供两种可行方案，你可以根据需求选择：

方案1：重写QGraphicsRectItem的paint方法（保留矩形特性） #

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
import smopy
from PIL.ImageQt import ImageQt

class MapWidget(QGraphicsRectItem):
    def __init__(self, parent=None):
        super(MapWidget, self).__init__(parent)
        self.setRect(0.0, 0.0, 800, 600)
        self.setFlags(self.ItemIsSelectable | self.ItemIsMovable)
        
        # 处理地图图片并持有引用（避免被垃圾回收）
        try:
            # 示例：获取北京附近的地图，替换成你需要的坐标/缩放级别
            map_img = smopy.Map((39.9, 116.3, 40.0, 116.4), z=13)
            pil_img = map_img.to_pil()
            # 转换为QPixmap并适配矩形尺寸
            self.map_pixmap = QPixmap.fromImage(ImageQt(pil_img))
            self.map_pixmap = self.map_pixmap.scaled(
                self.rect().size().toSize(), 
                Qt.KeepAspectRatio, 
                Qt.SmoothTransformation
            )
        except Exception as e:
            print(f"地图加载失败: {str(e)}")
            # 加载失败时设置默认占位图
            self.map_pixmap = QPixmap(800, 600)
            self.map_pixmap.fill(Qt.gray)

    def paint(self, painter, option, widget=None):
        # 可选：保留父类的矩形绘制（显示边框）
        super().paint(painter, option, widget)
        # 在矩形区域内绘制地图图片
        painter.drawPixmap(self.rect().toRect(), self.map_pixmap)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Map in QGraphicsScene")
        self.setGeometry(100, 100, 900, 700)
        
        # 初始化场景和视图
        self.scene = QGraphicsScene()
        self.view = QGraphicsView(self.scene, self)
        self.view.setGeometry(50, 50, 800, 600)
        
        # 添加地图项到场景
        self.map_item = MapWidget()
        self.scene.addItem(self.map_item)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

方案2：直接使用QGraphicsPixmapItem（更简洁） #

如果不需要矩形的特殊特性，直接用专门的图片项会更稳妥：

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
import smopy
from PIL.ImageQt import ImageQt

class MapWidget(QGraphicsPixmapItem):
    def __init__(self, parent=None):
        super().__init__(parent)
        try:
            map_img = smopy.Map((39.9, 116.3, 40.0, 116.4), z=13)
            pil_img = map_img.to_pil()
            pixmap = QPixmap.fromImage(ImageQt(pil_img))
            # 设置图片并适配尺寸
            self.setPixmap(pixmap.scaled(800, 600, Qt.KeepAspectRatio))
            self.setFlags(self.ItemIsSelectable | self.ItemIsMovable)
        except Exception as e:
            print(f"地图加载失败: {str(e)}")
            self.setPixmap(QPixmap(800, 600).filled(Qt.gray))

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Map in QGraphicsScene")
        self.setGeometry(100, 100, 900, 700)
        
        self.scene = QGraphicsScene()
        self.view = QGraphicsView(self.scene, self)
        self.view.setGeometry(50, 50, 800, 600)
        
        self.map_item = MapWidget()
        self.scene.addItem(self.map_item)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键改动说明 #

1. 持有图片引用：将map_pixmap设为类的实例变量，避免被垃圾回收，确保绘制时资源有效。
2. 重写paint方法（方案1）：通过painter.drawPixmap在矩形区域内绘制图片，同时可以保留原矩形的边框显示。
3. 异常捕获：添加了地图加载的异常处理，避免因网络或API问题导致崩溃。
4. 尺寸适配：用scaled方法让图片适配目标区域，保证显示效果正常。

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