From a54e6a3f3f0a401d85523bd325f2a876e22f4e2f Mon Sep 17 00:00:00 2001
From: tison <wander4096@gmail.com>
Date: Sun, 4 Oct 2026 00:28:43 +0800
Subject: [PATCH] fix(singleflight): drop duplicate keys outside the table lock

---
 CHANGELOG.md                                 |  4 +
 asyncband/src/singleflight/mod.rs            | 23 ++---
 tests-integration/tests/singleflight_test.rs | 89 ++++++++++++++++++++
 3 files changed, 105 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a59b9983..6f226004 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,10 @@ All notable changes to this project will be documented in this file.
 
 * Add bounded MPMC `reserve` and `try_reserve` methods returning a borrowed `Permit`, so callers can wait for capacity before constructing a value; sends and reservations receive capacity in wait-queue order, and unused permits release it.
 
+### Bug fixes
+
+* Prevent deadlocks in `singleflight::Group::work` and `try_work` when a duplicate key's destructor calls back into the same group.
+
 ### Notable changes
 
 * Executor waker operations, including cloning, waking, and dropping, are expected not to panic; recovery from panicking waker callbacks is no longer supported.
diff --git a/asyncband/src/singleflight/mod.rs b/asyncband/src/singleflight/mod.rs
index c677a7e1..104193ac 100644
--- a/asyncband/src/singleflight/mod.rs
+++ b/asyncband/src/singleflight/mod.rs
@@ -74,17 +74,18 @@ where
     fn get_or_insert(&self, key: K) -> Arc<Entry<K, V>> {
         let hash = self.hasher.hash_one(&key);
         let mut entries = self.entries.lock();
-        entries
-            .entry(hash, |entry| entry.key.eq(&key), |entry| entry.hash)
-            .or_insert_with(|| {
-                Arc::new(Entry {
-                    hash,
-                    key,
-                    cell: OnceCell::new(),
-                })
-            })
-            .into_mut()
-            .clone()
+        // Drop duplicate keys after unlocking: their destructors may reenter the group.
+        if let Some(entry) = entries.find(hash, |entry| entry.key.eq(&key)) {
+            return entry.clone();
+        }
+
+        let entry = Arc::new(Entry {
+            hash,
+            key,
+            cell: OnceCell::new(),
+        });
+        entries.insert_unique(hash, entry.clone(), |entry| entry.hash);
+        entry
     }
 
     fn remove<Q>(&self, key: &Q)
diff --git a/tests-integration/tests/singleflight_test.rs b/tests-integration/tests/singleflight_test.rs
index 87008f36..284a51b4 100644
--- a/tests-integration/tests/singleflight_test.rs
+++ b/tests-integration/tests/singleflight_test.rs
@@ -15,10 +15,18 @@
 // specific language governing permissions and limitations
 // under the License.
 
+use std::borrow::Borrow;
+use std::cell::Cell;
+use std::hash::Hash;
+use std::hash::Hasher;
+use std::pin::pin;
+use std::rc::Rc;
 use std::sync::atomic::AtomicUsize;
 use std::sync::atomic::Ordering;
+use std::task::Poll;
 
 use asyncband::singleflight::Group;
+use tests_integration::assert_completes_without_deadlock;
 use tests_integration::poll_once;
 
 #[tokio::test]
@@ -164,3 +172,84 @@ async fn concurrent_try_work_is_coalesced() {
     }
     assert_eq!(counter.load(Ordering::SeqCst), 1);
 }
+
+#[test]
+fn duplicate_key_destructor_can_forget_another_key() {
+    struct Key {
+        value: usize,
+        on_drop: Option<Box<dyn FnOnce()>>,
+    }
+
+    impl Borrow<usize> for Key {
+        fn borrow(&self) -> &usize {
+            &self.value
+        }
+    }
+
+    impl PartialEq for Key {
+        fn eq(&self, other: &Self) -> bool {
+            self.value == other.value
+        }
+    }
+
+    impl Eq for Key {}
+
+    impl Hash for Key {
+        fn hash<H: Hasher>(&self, state: &mut H) {
+            self.value.hash(state);
+        }
+    }
+
+    impl Drop for Key {
+        fn drop(&mut self) {
+            if let Some(on_drop) = self.on_drop.take() {
+                on_drop();
+            }
+        }
+    }
+
+    assert_completes_without_deadlock(|| {
+        for fallible in [false, true] {
+            let group = Rc::new(Group::new());
+            let (release_tx, release_rx) = tokio::sync::oneshot::channel();
+            let mut leader = pin!(group.work(
+                Key {
+                    value: 7,
+                    on_drop: None,
+                },
+                async || {
+                    release_rx.await.unwrap();
+                    "leader"
+                }
+            ));
+            assert!(poll_once(leader.as_mut()).is_pending());
+
+            let key_dropped = Rc::new(Cell::new(false));
+            let dropped = key_dropped.clone();
+            let weak = Rc::downgrade(&group);
+            let key = Key {
+                value: 7,
+                on_drop: Some(Box::new(move || {
+                    weak.upgrade().unwrap().forget(&42_usize);
+                    dropped.set(true);
+                })),
+            };
+            let mut duplicate = pin!(async {
+                if fallible {
+                    group
+                        .try_work(key, async || Ok::<_, ()>("duplicate"))
+                        .await
+                        .unwrap()
+                } else {
+                    group.work(key, async || "duplicate").await
+                }
+            });
+            assert!(poll_once(duplicate.as_mut()).is_pending());
+            assert!(key_dropped.get());
+
+            release_tx.send(()).unwrap();
+            assert_eq!(poll_once(leader.as_mut()), Poll::Ready("leader"));
+            assert_eq!(poll_once(duplicate.as_mut()), Poll::Ready("leader"));
+        }
+    });
+}