为什么在Go语言中使用互斥锁时会出现“fatal error: sync: unlock of unlocked mutex”的错误？-Golang-PHP中文网

为什么在Go语言中使用互斥锁时会出现“fatal error: sync: unlock of unlocked mutex”的错误？

花韻仙語

发布： 2025-03-16 11:02:01

原创

901人浏览过

关于go语言中互斥锁的奇怪bug

在go语言中，使用互斥锁（mutex）来保护共享资源是常见的做法。然而，有时可能会遇到一些奇怪的bug，例如在快速操作时出现“fatal error: sync: unlock of unlocked mutex”的错误。本文将探讨这个问题，并提供解决方案。

问题描述

假设我们有以下代码片段：

fmt.println("1.开始加锁" + key)
s.lock()
fmt.println("2.加锁完成" + key)

defer fmt.println("5.解锁完成" + key)
defer s.unlock()
defer fmt.println("4.开始解锁" + key)

登录后复制

当在前端页面快速点击菜单或刷新页面时，前几次操作一切正常，但随后会报错“fatal error: sync: unlock of unlocked mutex”。以下是点击菜单或刷新后的结果：

第一次：正常
第二次：正常
第三次：正常
第四次：正常
第五次：正常
第六次：错误来了

问题分析

问题出在对互斥锁的使用上。特别是当互斥锁是全局变量时，可能会导致多个goroutine对同一个锁进行操作，从而引发问题。

以下是问题的示例代码：

立即学习“go语言免费学习笔记（深入）”；

package category

import (
    "sync"
)

type sync struct {
    name string
    age  int
    mu   sync.mutex
}

var (
    cache          *sync
    cachecontainer sync
)

// gettree 查询列表
func (s *sync) gettree() *sync {
    s.mu.lock()
    defer s.mu.unlock()
    cache = &sync{
        name: "abc",
        age:  18,
    }
    // 这里多此一举就出错了，多请求几次就会报：fatal error: sync: unlock of unlocked mutex
    cachecontainer = *cache
    return &cachecontainer
}

// gettree2 正确
func (s *sync) gettree2() *sync {
    s.mu.lock()
    defer s.mu.unlock()
    cache = &sync{
        name: "abc",
        age:  18,
    }
    return cache
}

登录后复制

问题解决

问题的关键在于s是否为全局变量。如果s是一个全局变量，那么多个goroutine可能会同时访问和修改s，从而导致互斥锁被多次解锁，引发“fatal error: sync: unlock of unlocked mutex”错误。

云雀语言模型

云雀是一款由字节跳动研发的语言模型，通过便捷的自然语言交互，能够高效的完成互动对话

查看详情

要解决这个问题，可以确保每个goroutine使用自己的互斥锁实例，而不是共享全局变量。以下是修改后的正确代码：

// GetTree2 正确
func (s *Sync) GetTree2() *Sync {
    s.Mu.Lock()
    defer s.Mu.Unlock()
    Cache = &Sync{
        Name: "abc",
        age:  18,
    }
    return Cache
}

登录后复制

在gettree2函数中，每次调用都会返回一个新的sync实例，而不是对全局变量进行操作，从而避免了互斥锁的冲突。