Skip to content

Conversation

@shanto12
Copy link

The state.All() method had a race condition where it unlocked the mutex inside the range loop over the map, leaving the map unprotected during iteration. This could trigger the race detector and cause concurrent map access issues.

This fix creates a copy of the map while holding the lock, then iterates over the copy without holding the lock. This ensures thread-safe iteration without blocking other operations for extended periods.

Fixes #309

The state.All() method had a race condition where it unlocked the mutex inside the range loop over the map, leaving the map unprotected during iteration. This could trigger the race detector and cause concurrent map access issues.

This fix creates a copy of the map while holding the lock, then iterates over the copy without holding the lock. This ensures thread-safe iteration without blocking other operations for extended periods.

Fixes google#309
@google-cla
Copy link

google-cla bot commented Nov 20, 2025

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @shanto12, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request resolves a critical race condition within the state.All() method, which previously exposed the underlying map to concurrent access issues during iteration. By adopting a copy-on-read approach, the change ensures that map iteration is performed on a consistent snapshot, thereby enhancing the stability and thread-safety of the system without introducing prolonged lock contention.

Highlights

  • Race Condition Fix: Addressed a race condition in the state.All() method where the mutex was incorrectly unlocked during map iteration, potentially leading to concurrent map access issues.
  • Thread-Safe Iteration: Implemented a thread-safe iteration strategy for the state.All() method by creating a copy of the map while holding a read lock, then iterating over this immutable copy without holding the lock, ensuring data consistency and preventing deadlocks.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request correctly fixes a critical race condition in the state.All() method. The approach of creating a copy of the map under a lock before iterating is sound and effectively prevents concurrent access issues. My review includes a suggestion to further improve the implementation by fixing significant indentation problems, using the more idiomatic maps.Clone function, and renaming a variable that shadows a built-in Go function. Applying this suggestion will enhance the code's readability and maintainability.

Comment on lines +384 to 399
return func(yield func(key string, val any) bool) {
// Create a copy of the map while holding the lock
s.mu.RLock()
copy := make(map[string]any, len(s.state))
for k, v := range s.state {
copy[k] = v
}
s.mu.RUnlock()
if !yield(k, v) {
return

// Iterate over the copy without holding the lock
for k, v := range copy {
if !yield(k, v) {
return
}
}
s.mu.RLock()
}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

This change correctly fixes the race condition. However, the implementation can be improved:

  1. Formatting: The indentation throughout this function is incorrect, likely due to a mix of tabs and spaces, which harms readability. Running gofmt would resolve this.
  2. Idiomatic Code: The manual map copy can be simplified to a single call to maps.Clone, which is already used in this package and is more idiomatic.
  3. Naming: The variable name copy shadows Go's built-in copy function. It's a best practice to avoid this by choosing a more descriptive name like stateCopy.

The suggestion below applies all these improvements.

    return func(yield func(key string, val any) bool) {
        // Create a copy of the map while holding the lock
        s.mu.RLock()
        stateCopy := maps.Clone(s.state)
        s.mu.RUnlock()

        // Iterate over the copy without holding the lock
        for k, v := range stateCopy {
            if !yield(k, v) {
                return
            }
        }
    }

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implementations of State.All() are not thread-safe and trigger the race detector

1 participant