iOS Composable Architecture模态弹窗冲突与模块依赖问题求助

一、模态弹窗呈现冲突问题 #

问题场景 #

使用TCA的StackState实现页面推送流程：

Recipe List -- push -> Recipe Detail View -- Push -> Ingredient Details

当Ingredient Details以模态方式呈现时：

Recipe List -- push -> Recipe Detail View ^^ modal ^^ Ingredient Details

此时根模块收到深度链接需模态呈现新页面，会出现「同时呈现两个模态弹窗」的冲突：

Recipe List -- push -> Recipe Detail View ^^ modal ^^ Ingredient Details
  |^^ Recipe detail view ^^

解决方案 #

纯SwiftUI结合TCA状态管理方案

• 全局状态跟踪模态状态：在根状态中添加isAnyModalActive: Bool字段，所有子Reducer在更新自身PresentationState时，同步更新这个全局状态。根模块处理深度链接前，先检查该字段，若为true则先发送关闭当前模态的Action，再呈现新模态。
• 统一根层级模态管理：将所有模态呈现逻辑收敛到根Reducer的PresentationState中，子模块不再独立管理模态，而是通过发送Action请求根模块触发模态呈现。这样根模块可以完全控制模态的叠加逻辑，避免冲突。
• SwiftUI环境协调器：自定义ModalCoordinator ObservableObject，注入到SwiftUI环境中，所有模态的isPresented绑定都通过该协调器控制。协调器内部维护当前活跃模态的标记，当新模态请求呈现时，自动关闭已有模态：

  class ModalCoordinator: ObservableObject {
      @Published var currentModal: ModalType?
      
      enum ModalType {
          case ingredientDetails
          case dailyRecipe
      }
  }
  
  // 使用时
  .environmentObject(ModalCoordinator())
  // 触发模态
  coordinator.currentModal = .dailyRecipe
  

二、模块化架构下的循环依赖问题 #

问题场景 #

Recipe和Ingredient详情页分属不同模块，Ingredient详情页需打开「使用该食材的食谱」详情页，导致模块间互相引用：

Recipe List -- push -> Recipe Detail View -- Push -> Ingredient Details -- Push -> Recipe Detail View

解决方案 #

协议驱动的解耦方案

• 共享协议定义：创建独立的Shared模块，定义RecipeNavigatable协议：

  // Shared/Protocols/RecipeNavigatable.swift
  protocol RecipeNavigatable {
      func openRecipeDetail(id: RecipeID)
  }
  

  Recipe模块实现该协议，Ingredient模块仅依赖Shared模块，通过协议实例发起导航请求，无需直接引用Recipe模块。
• TCA依赖注入：在Ingredient模块的Reducer中定义导航依赖：

  // Ingredient/Reducer/IngredientReducer.swift
  struct IngredientEnvironment {
      var openRecipeDetail: (RecipeID) -> Effect<Never, Never>
  }
  

  主应用在组装Ingredient模块时，注入Recipe模块的导航逻辑：

  let ingredientEnvironment = IngredientEnvironment(
      openRecipeDetail: { id in
          .send(RecipeAction.pushDetail(id: id))
      }
  )
  

• 集中式路由管理：创建Router模块，统一维护所有页面的路由表，各业务模块通过Router发起导航请求，模块间仅依赖Router模块，彻底消除循环依赖：

  // Router/Router.swift
  enum Route {
      case recipeDetail(id: RecipeID)
      case ingredientDetail(id: IngredientID)
  }
  
  class AppRouter: ObservableObject {
      func navigate(to route: Route) {
          // 处理导航逻辑
      }
  }
  

内容的提问来源于stack exchange，提问作者Saren Inden