如何仅在QT应用出现卡顿丢帧时进行性能分析？

一、QT中实现丢帧检测 #

根据应用类型（QWidget/QML），通过跟踪帧间隔判断丢帧：

QWidget/QApplication 场景 #

重载paintEvent或用QElapsedTimer记录每帧时间，当帧间隔超过目标帧率对应时长的一定比例时（比如60fps对应16.67ms，超过50%即25ms）判定为丢帧：

#include <QElapsedTimer>
QElapsedTimer frameTimer;
qint64 lastFrameTime = 0;
const qint64 targetFrameInterval = 1000 / 60; // 约16.67ms

void MyWidget::paintEvent(QPaintEvent *event) {
    QWidget::paintEvent(event);
    qint64 currentTime = frameTimer.elapsed();
    qint64 frameInterval = currentTime - lastFrameTime;
    
    // 阈值可根据实际情况调整
    if (frameInterval > targetFrameInterval * 1.5) {
        markFrameDrop();
    }
    lastFrameTime = currentTime;
}

// 初始化时调用 frameTimer.start();

QML/QQuickWindow 场景 #

利用QQuickWindow::afterRendering信号，在每次渲染完成后计算帧间隔：

#include <QQuickWindow>
#include <QElapsedTimer>

QElapsedTimer frameTimer;
qint64 lastFrameTime = 0;
const qint64 targetFrameInterval = 1000 / 60;

void initFrameMonitor(QQuickWindow* quickWindow) {
    connect(quickWindow, &QQuickWindow::afterRendering, quickWindow, [=]() {
        qint64 currentTime = frameTimer.elapsed();
        qint64 frameInterval = currentTime - lastFrameTime;
        
        if (frameInterval > targetFrameInterval * 1.5) {
            markFrameDrop();
        }
        lastFrameTime = currentTime;
    });
    frameTimer.start();
}

二、与perf联动，仅记录丢帧时段数据 #

方法1：自定义perf事件触发采样 #

在应用中通过系统调用发送自定义perf事件，让perf仅在事件发生时记录调用栈：

1. 初始化并发送事件的代码：

#include <sys/syscall.h>
#include <linux/perf_event.h>
#include <unistd.h>

int perfEventFd = -1;

void initPerfEvent() {
    struct perf_event_attr attr = {};
    attr.type = PERF_TYPE_SOFTWARE;
    attr.config = PERF_COUNT_SW_BPF_OUTPUT;
    attr.size = sizeof(attr);
    attr.sample_type = PERF_SAMPLE_RAW;
    attr.wakeup_events = 1;

    perfEventFd = syscall(__NR_perf_event_open, &attr, 0, -1, -1, 0);
}

void markFrameDrop() {
    if (perfEventFd != -1) {
        uint64_t trigger = 1;
        write(perfEventFd, &trigger, sizeof(trigger));
    }
}

2. 启动perf时监听该事件：

perf record -e software:bpf_output -g -- ./your_qt_app

分析时仅会看到丢帧触发时的调用栈数据。

方法2：动态添加perf探针 #

无需修改应用核心逻辑，直接在markFrameDrop函数处添加探针，记录触发时的调用栈：

# 为markFrameDrop函数添加探针
perf probe -x ./your_qt_app markFrameDrop
# 记录探针触发时的调用栈
perf record -e probe:markFrameDrop -g -- ./your_qt_app

方法3：丢帧时生成独立perf快照 #

丢帧时启动独立perf进程，短暂记录性能数据：

#include <QProcess>
#include <QDateTime>

void markFrameDrop() {
    // 生成唯一文件名，记录200ms的性能数据
    QString perfFile = QString("perf_drop_%1.data").arg(QDateTime::currentMSecsSinceEpoch());
    QString cmd = QString("perf record -g -o %1 -- sleep 0.2").arg(perfFile);
    QProcess::startDetached(cmd);
}

事后用perf report -i perf_drop_xxx.data逐个分析丢帧时段数据。

三、无需修改代码的替代方案 #

• QQuickProfiler：针对QML应用，可在Qt Creator中直接记录帧渲染耗时，定位到耗时过长的QML组件或逻辑。
• Qt Creator性能分析器：采样CPU使用情况后，通过时间轴筛选丢帧时段，仅查看该区间的调用栈数据。

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