ENG-8507: rebind MutableProxy when it is linked to an old _self_state reference

Avoids an issue where MutableProxy references are saved in the state, then when
accessing them again, they reference the wrong StateProxy. So even though the
code enters `async with self`, the StateProxy that is marked mutable is NOT the
StateProxy associated with the value.

With this change, anytime a MutableProxy is accessed through a StateProxy, its
state reference is reset to the current StateProxy before returning it.

Author: masenf

reflex/istate/proxy.py

@@ -508,8 +508,13 @@ def _wrap_recursive(self, value: Any) -> Any:
         # When called from dataclasses internal code, return the unwrapped value
         if self._is_called_from_dataclasses_internal():
             return value
-        # Recursively wrap mutable types, but do not re-wrap MutableProxy instances.
-        if is_mutable_type(type(value)) and not isinstance(value, MutableProxy):
+        # If we already have a proxy, make sure the state reference is up to date and return it.
+        if isinstance(value, MutableProxy):
+            if value._self_state is not self._self_state:
+                value._self_state = self._self_state
+            return value
+        # Recursively wrap mutable types.
+        if is_mutable_type(type(value)):
             base_cls = globals()[self.__base_proxy__]
             return base_cls(
                 wrapped=value,

tests/units/test_state.py

@@ -4386,3 +4386,48 @@ async def fetch_data_state(self) -> None:
     state = await mock_app.state_manager.get_state(_substate_key(token, OtherState))
     other_state = await state.get_state(OtherState)
     await other_state.fetch_data_state()  # Should not raise exception.
+
+
+class MutableProxyState(BaseState):
+    """A test state with a MutableProxy var."""
+
+    data: dict[str, list[int]] = {"a": [1], "b": [2]}
+
+
+@pytest.mark.asyncio
+async def test_rebind_mutable_proxy(mock_app: rx.App, token: str) -> None:
+    """Test that previously bound MutableProxy instances can be rebound correctly."""
+    mock_app.state_manager.state = mock_app._state = MutableProxyState
+    state = await mock_app.state_manager.get_state(
+        _substate_key(token, MutableProxyState)
+    )
+    state.router = RouterData.from_router_data({
+        "query": {},
+        "token": token,
+        "sid": "test_sid",
+    })
+    state_proxy = StateProxy(state)
+    assert isinstance(state_proxy.data, MutableProxy)
+    async with state_proxy:
+        state_proxy.data["a"] = state_proxy.data["b"]
+    assert state_proxy.data["a"] is not state_proxy.data["b"]
+    assert state_proxy.data["a"].__wrapped__ is state_proxy.data["b"].__wrapped__
+
+    new_state_proxy = StateProxy(state)
+    assert state_proxy is not new_state_proxy
+    assert new_state_proxy.data["a"]._self_state is new_state_proxy
+    assert state_proxy.data["a"]._self_state is state_proxy
+
+    async with state_proxy:
+        state_proxy.data["a"].append(3)
+
+    state = await mock_app.state_manager.get_state(
+        _substate_key(token, MutableProxyState)
+    )
+    assert state.data["a"] == [2, 3]
+    if isinstance(mock_app.state_manager, StateManagerRedis):
+        # In redis mode, the object identity does not persist across async with self calls.
+        assert state.data["b"] == [2]
+    else:
+        # In disk/memory mode, the fact that data["b"] was mutated via data["a"] persists.
+        assert state.data["b"] == [2, 3]