嵌入式 Linux 与 RTOS / 系统课时
定位队列阻塞与消息丢失
定位队列阻塞与消息丢失
队列故障最容易被误判成“消息莫名丢了”。真正要确认的是发送是否失败、发送者等了多久、队列曾经多满,以及消费者有没有长期跟不上。本节用一个故意过载的 FreeRTOS 队列实验建立诊断指标,再区分未入队、超时放弃与主动覆盖。
学习目标
- 能用发送返回值、等待时长和队列水位定位阻塞点。
- 能区分真正未入队、等待超时后放弃和主动覆盖三类现象。
- 能依据峰值速率、消费者停顿时间和允许延迟调整容量与背压。
先把三类现象分开
xQueueSend() 返回 pdPASS,说明消息已经进入队列;返回 errQUEUE_FULL,才表示这次发送没有成功入队。若调用者在失败后直接放弃数据,这是发送超时后的业务丢弃,并不是 FreeRTOS 在队列内部随机删除了消息。
“覆盖”又是另一种明确策略。xQueueOverwrite() 主要用于长度为 1 的队列,用最新值替换旧值,适合只关心当前状态的邮箱式数据;要求每条命令、告警或审计事件都被消费时,不应使用这种语义。

制造并记录队列压力
下面的实验可放入已有 FreeRTOS 工程的 main.c,并假设项目已经把 printf() 重定向到串口或其他调试输出。队列容量只有 3,生产者每 10 ms 发送一次,消费者处理一条却需要 80 ms,因此能够稳定制造高水位和发送超时。
#include "FreeRTOS.h"
#include "task.h"
#include "queue.h"
#include <stdint.h>
#include <stdio.h>
typedef struct {
uint32_t seq;
} Message;
static QueueHandle_t gQueue;
static void producerTask(void *arg) {
uint32_t seq = 0;
(void)arg;
for (;;) {
Message msg = { .seq = seq++ };
TickType_t start = xTaskGetTickCount();
// 最多等 5 ms,用返回值和等待时间暴露队列满问题。
BaseType_t ok = xQueueSend(gQueue, &msg, pdMS_TO_TICKS(5));
TickType_t waited = xTaskGetTickCount() - start;
UBaseType_t depth = uxQueueMessagesWaiting(gQueue);
printf("TX seq=%lu result=%s waited=%lu depth=%lu\n",
(unsigned long)msg.seq,
ok == pdPASS ? "PASS" : "FULL",
(unsigned long)waited,
(unsigned long)depth);
vTaskDelay(pdMS_TO_TICKS(10));
}
}
static void consumerTask(void *arg) {
Message msg;
(void)arg;
for (;;) {
if (xQueueReceive(gQueue, &msg, pdMS_TO_TICKS(100)) == pdPASS) {
printf("RX seq=%lu\n", (unsigned long)msg.seq);
// 故意降低消费速度,模拟业务处理过慢。
vTaskDelay(pdMS_TO_TICKS(80));
} else {
printf("RX timeout\n");
}
}
}
int main(void) {
gQueue = xQueueCreate(3, sizeof(Message));
if (gQueue == NULL) {
return 1;
}
// 生产者优先级更高,使过载现象更容易观察。
xTaskCreate(producerTask, "producer", configMINIMAL_STACK_SIZE + 128,
NULL, tskIDLE_PRIORITY + 2, NULL);
xTaskCreate(consumerTask, "consumer", configMINIMAL_STACK_SIZE + 128,
NULL, tskIDLE_PRIORITY + 1, NULL);
vTaskStartScheduler();
return 0;
}预期输出(具体顺序和等待 tick 数会随调度时机变化)
TX seq=0 result=PASS waited=0 depth=1
RX seq=0
TX seq=1 result=PASS waited=0 depth=1
TX seq=2 result=PASS waited=0 depth=2
TX seq=3 result=PASS waited=0 depth=3
TX seq=4 result=FULL waited=<TIME> depth=3
RX seq=1
TX seq=5 result=PASS waited=<TIME> depth=3<TIME> 的实际值取决于 tick 频率和调度时机。诊断时不要只保存一次 FULL,而应累计发送失败次数、最长等待时间和历史最高水位;“经常满但最终发送成功”与“频繁等待到期后放弃”对应不同严重程度。
按顺序定位阻塞来源
先查发送端。若 errQUEUE_FULL 计数增长,说明对应消息确实没有进入队列;若发送一直成功但业务层仍出现序号缺口,就应继续检查消费者之后的处理链、业务过滤或去重逻辑。
再查消费者。xQueueReceive() 超时只表示等待窗口内没有收到消息,并不等于消息丢失。若队列长期接近满水位,同时单条消费时间明显大于生产间隔,根因通常是消费者吞吐不足。
最后检查调度条件。高优先级任务长期占用 CPU、临界区过长或消费者优先级过低,都可能使平均吞吐看似足够的消费者在局部时间窗内无法运行,从而产生瞬时积压。
重新设计容量与背压
队列容量不能只按平均速率估计。更可靠的方法是测出消费者最坏情况下可能停止消费多久,再计算这段时间的峰值生产量并加入余量。例如峰值每 10 ms 一条,而消费者最长可能连续 200 ms 得不到调度,仅吸收这一段突发就需要约 20 个槽位。
消息必须逐条保留时,应优先提高消费者吞吐、扩大缓冲,或让生产者承担可接受的阻塞;允许丢弃时,则要明确采用丢最新、丢旧数据或采样降频,并暴露丢弃计数。业务只关心最新状态时才适合长度为 1 的覆盖队列。
调整后应重复同样的压力测试。验收标准是峰值场景下发送失败率符合业务预算、最长等待小于允许延迟、最高水位留有余量,并且突发结束后消费者能够及时清空积压。