# 多线程开发常见问题

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# 任务创建应该用哪个接口？

优先使用：

- *qosa_task_create*

在明确需要自管栈和TCB内存时，考虑：

- *qosa_task_create_static*

静态创建适合：

- 对内存可控性要求很高

- 需要避免动态分配

- 想把线程内存放到指定区域

静态创建有额外约束：

- 需要提供 *stackMem*

- *tcbMem* 需要满足最小大小和对齐要求

SDK提供了配套查询接口：

- *qosa_task_get_tcb_min_size*

- *qosa_task_get_tcb_align*

# 线程栈多大合适？

建议大小：

- QCM monitor task栈：2048

最后根据实际业务调整

# 优先级应该怎么选？

默认档位是：

- *QOSA_PRIORITY_REALTIME* = 99

- *QOSA_PRIORITY_HIGH* = 80

- *QOSA_PRIORITY_ABOVE_NORMAL* = 60

- *QOSA_PRIORITY_NORMAL* = 40

- *QOSA_PRIORITY_BELOW_NORMAL* = 20

- *QOSA_PRIORITY_LOW* = 10

- *QOSA_PRIORITY_IDLE* = 1

推荐做法：

- 常规业务线程用 *QOSA_PRIORITY_NORMAL*

- 对时延敏感但不是中断级别的线程用 *QOSA_PRIORITY_ABOVE_NORMAL*

- 后台清理、低频处理线程用 *QOSA_PRIORITY_BELOW_NORMAL* 或 *QOSA_PRIORITY_LOW* 

- 不要轻易把业务线程拉到 *QOSA_PRIORITY_REALTIME* 或 *QOSA_PRIORITY_HIGH*

# 为什么线程创建成功，但系统表现越来越卡？

- 高优先级线程里做了阻塞I/O

- while死循环里没有等待点

- 反复轮询状态，没有用信号量或消息队列

- 持锁时间太长

- 在中心线程或回调线程里做耗时业务

# 互斥锁、信号量、消息队列、事件标志应该怎么选？

## 互斥锁

适合保护共享资源，例如：

- 全局链表

- 会话表

- 状态机上下文

- 文件句柄集合

## 信号量

适合做同步通知，例如：

- 一个线程等另一个线程完成初始化

- 中断或回调通知工作线程继续处理

SDK注释里对 *qosa_sem_create* 的建议明确：

- *initialCount* 通常设为 0

## 消息队列

适合跨线程传递事件和数据。

例如socket、NTP、MQTT、WebSocket、DTLS重传。

## 事件标志

- 等任一事件发生

- 等全部事件准备完成

# 为什么消息队列发送会失败？

*qosa_msgq_release* 头文件里已经明确说明：

- 队列满时，发布可能失败并返回负值

高频错误场景：

- 使用 *QOSA_NO_WAIT* 发送，但消费者处理不过来

- 队列深度太小

- 消费线程被更高优先级线程长期压制

- 把大对象当消息反复投递，处理路径太慢

建议：

1. 高频路径优先只投递轻量事件结构。

2. 根据峰值流量合理放大 *maxNumber*。

3. 对关键消息检查返回值，不能默认忽略。

4. 如果发送方不能阻塞，要设计丢弃策略和统计日志。

# 为什么加锁后会死锁？

## 忘记解锁

- lock后中途return

- lock后goto error，但error分支没unlock

## 锁顺序不一致

- 线程A先拿lock1再拿lock2

- 线程B先拿lock2再拿lock1

## 持锁做耗时操作

- 网络收发

- 文件读写

- AT命令等待

- 大块内存处理

## 在回调或中心线程里嵌套等待

看起来只是“等一下结果”，实际可能把系统关键线程卡死。

建议：

1. 全项目统一锁顺序。

2. 持锁区只做最小状态修改。

3. 需要耗时处理时，复制必要数据后尽快解锁。