NGXS Store 中在 Effect 内派发 Action 导致信号写入错误的解决方案

问题背景

在 Angular 17 与 NGXS Store 18.0.0 版本中，开发者遇到了一个关于信号(Signal)写入的有趣问题。当在 Angular 的 effect 函数中派发(dispatch)一个会修改状态的 Action 时，系统会抛出错误："Writing to signals is not allowed in a computed or an effect by default"。

技术原理分析

这个问题源于 NGXS Store 内部的状态流(state stream)实现方式。NGXS 使用了一个信号来跟踪状态变化，这个信号会在状态变更时同步更新。而在 Angular 的 effect 机制中，默认是不允许直接修改信号的，这是为了防止潜在的循环更新问题。

具体来说，NGXS 创建了一个信号来包装状态流：

private readonly _state = signal<StateContext>(...);

当 effect 中派发 Action 导致状态变更时，这个信号会立即尝试更新，从而触发了 Angular 的保护机制。

解决方案演进

NGXS 团队在 18.1.0 版本中修复了这个问题。修复的核心思路是调整状态流的信号更新机制，使其不会在 effect 执行过程中直接触发信号写入。

对于开发者而言，在修复版本发布前，可以采用以下临时解决方案：

1. 使用 Angular 的 untracked 函数包裹 dispatch 调用
2. 使用社区提供的 explicitEffect 替代 Angular 原生的 effect

最佳实践建议

虽然问题已经修复，但在使用 NGXS 与 Angular 信号时仍需注意：

1. 尽量避免在 effect 中执行复杂的状态变更逻辑
2. 对于复杂的交互流程，考虑将业务逻辑拆分到多个简单的 Action 中
3. 保持状态更新的单向数据流，避免循环依赖

升级建议

建议所有使用 NGXS 18.0.0 与 Angular 17 的开发者尽快升级到 NGXS 18.1.0 或更高版本，以获得更稳定的信号集成体验。

这个问题的解决展示了现代前端状态管理库与 Angular 信号系统深度集成的技术挑战，也为开发者提供了关于响应式编程边界条件的宝贵实践经验。