- 关于SemaphoreSlim 信号量的使用注意事项
SemaphoreSlim 类 (System.Threading)
- Wait/Release 成对性(try/finally);
- 嵌套 Wait 的死锁问题;
- 必须为 Wait 设置超时;
- 异步场景 WaitAsync 的正确使用;
- 重复Release/未Wait就Release的异常;
- 跨线程 Release 的逻辑混乱;
- 安全封装的最佳实践
- Wait/Release 成对性(try/finally)
风险点:若线程获取信号量后(Wait),因异常、逻辑跳转等未执行 Release,信号量计数无法恢复,后续线程会永久阻塞在 Wait 上(死锁)。
规避方法:用 try/finally 包裹 Wait 后的逻辑,确保无论是否异常,Release 都会执行。
错误示例(无 finally,异常导致不 Release):
privatereadonlySemaphoreSlim_globalSemaphore=new(2,2);privateasyncTaskTest1_WaitReleasePair(){// 错误示例:无finally,异常导致Release未执行Console.WriteLine("→ 错误示例(无finally):");try{_globalSemaphore.Wait();Console.WriteLine("错误示例:获取信号量后抛出异常");thrownewInvalidOperationException("模拟操作失败");// Release永远执行不到,信号量计数永久减少_globalSemaphore.Release();}catch(Exceptionex){Console.WriteLine($"错误示例异常:{ex.Message}");Console.WriteLine($"信号量当前计数:{_globalSemaphore.CurrentCount}(应为1,实际少1)");}}privatereadonlySemaphoreSlim_globalSemaphore=new(2,2);正确示例(try/finally 保证 Release):
privateasyncTaskTest1_WaitReleasePair_Safe(){// 正确示例:try/finally兜底,避免异常导致不ReleaseConsole.WriteLine("\n→ 正确示例(try/finally):");try{_globalSemaphore.Wait();Console.WriteLine("正确示例:获取信号量后抛出异常");thrownewInvalidOperationException("模拟操作失败");}catch(Exceptionex){Console.WriteLine($"正确示例异常:{ex.Message}");}finally{_globalSemaphore.Release();Console.WriteLine($"finally执行Release,信号量当前计数:{_globalSemaphore.CurrentCount}(恢复为2)");}}- SemaphoreSlim嵌套 Wait 的死锁问题
同一线程多次 Wait 同一信号量,会消耗多个计数;若计数不足,内部 Wait 会阻塞,而线程本身持有信号量未释放,导致其他线程也无法释放,最终死锁。 - 死锁本质:SemaphoreSlim 是「无所有权的计数信号量」,无 “线程持有计数” 的记录,仅做计数增减;同一线程嵌套 Wait 会持续消耗计数,当计数耗尽后,线程自身阻塞在 Wait 上,无法执行 Release 恢复计数,形成「自死锁」。
一般在全局变量的SemaphoreSlim,多个方法嵌套使用的时候需要注意。
// ❌ 危险代码:导致死锁privateSemaphoreSlim_semaphore=newSemaphoreSlim(1);publicasyncTaskDangerousMethodAsync(){await_semaphore.WaitAsync();// 在持有锁的情况下,等待另一个也需要相同锁的操作awaitAnotherMethodThatAlsoUsesTheSemaphoreAsync();// 死锁!_semaphore.Release();}publicasyncTaskAnotherMethodThatAlsoUsesTheSemaphoreAsync(){await_semaphore.WaitAsync();// 这个等待永远不会返回,因为锁被DangerousMethodAsync占用了try{/* 一些操作 */}finally{_semaphore.Release();}}- 必须为 Wait 设置超时,避免无限阻塞
风险点:若 Wait() 无超时,线程会无限等待信号量;若信号量因 BUG(如 Release 遗漏)永远无法释放,线程会永久阻塞(死锁)。
规避方法:使用 Wait(int millisecondsTimeout) 或 Wait(CancellationToken),判断是否成功获取信号量,失败则直接退出。
错误示例(无超时,无限等待):
// 线程阻塞在Wait上,永远无法唤醒(死锁)publicvoidNoTimeoutWait(){_semaphore.Wait();// 无超时,若信号量计数为0,永久阻塞try{DoWork();}finally{_semaphore.Release();}}正确示例(带超时,失败则处理):
publicvoidTimeoutWait(){// 等待1秒,获取失败则返回falseboolacquired=_semaphore.Wait(1000);if(!acquired){// 超时处理(如日志、重试),避免死锁Console.WriteLine("获取信号量超时,放弃执行");return;}try{DoWork();}finally{_semaphore.Release();}}- 异步场景 WaitAsync 的正确使用
风险点:在 UI 线程(如 WPF)或异步上下文用 Wait()(同步阻塞),会占用线程且无法释放信号量,导致死锁。规避方法:用 WaitAsync() 配合 async/await,异步等待不阻塞线程,确保后续 Release 能执行。
privateasyncvoidBtn_Click(objectsender,RoutedEventArgse){// 正确示例:异步场景用WaitAsync,无阻塞+上下文连续Console.WriteLine("\n→ 正确示例(异步场景WaitAsync):");try{awaitsemaphore.WaitAsync();// 异步等待,不阻塞线程Console.WriteLine("WaitAsync:获取信号量");stringdata=awaitTask.Run(()=>{Thread.Sleep(1000);return"模拟数据";});Console.WriteLine($"WaitAsync:线程切换后数据={data}");}finally{semaphore.Release();// 同一异步流,逻辑成对Console.WriteLine("WaitAsync:Release执行(安全)");}}- 重复Release/未Wait就Release的异常
风险点:
- 未 Wait 直接 Release:会导致信号量计数超过最大值,后续 Wait 逻辑混乱,可能引发线程安全问题;
- 重复 Release:同样导致计数异常,若计数溢出,会抛 SemaphoreFullException,进而导致后续线程无法正常获取信号量(间接死锁)。
错误示例(重复 Release):
publicvoidDuplicateRelease(){_semaphore.Wait();try{DoWork();}finally{_semaphore.Release();// 计数+1(正确)_semaphore.Release();// 重复Release,计数超出最大值,抛异常}}SemaphoreSlim:本质是计数信号量,仅管理 “可用计数”,不校验 Wait/Release 是否在同一线程(Release 只做计数 + 1,不管是谁调用。
- Wait 后线程切换的典型场景(异步 + WPF 高发),跨线程 Release 的逻辑混乱
最常见的线程切换场景是:在 async 方法中用同步 Wait(SemaphoreSlim.Wait()),后续 await 导致线程切换,最终 Release 跑在另一个线程,引发计数异常。
错误示例(WPF 中 Wait 后线程切换,Release 错位)
privatestaticreadonlySemaphoreSlim_semaphore=new(1,1);// 单线程并发// WPF 按钮点击事件(UI线程)privateasyncvoidBtn_Click(objectsender,RoutedEventArgse){// 步骤1:UI线程调用Wait,获取信号量(计数1→0)_semaphore.Wait();try{// 步骤2:await 触发线程切换(UI线程释放,后台线程执行)stringdata=awaitTask.Run(()=>{Thread.Sleep(1000);return"后台数据";});// 步骤3:await 后切回UI线程(逻辑上还是原上下文,但如果是控制台/ASP.NET,可能切到线程池其他线程)// 问题:若此处不是UI线程(比如ASP.NET),Release 就跑在非 Wait 的线程上ResultText.Text=data;}finally{// 风险:Release 线程 ≠ Wait 线程(虽SemaphoreSlim不抛异常,但计数逻辑易乱)// 极端情况:若await后线程被销毁/阻塞,Release 执行时机不可控,导致计数异常_semaphore.Release();}}