Vue / 系统课时

异步 Action 与错误状态

异步 Action 与错误状态

异步 Action 的重点不是把 fetch 塞进 Store,而是让加载、成功、失败和重试都变成可观察状态。本课用一个用户加载 Store 建立完整请求生命周期,并补上重复请求与旧响应覆盖新数据的边界处理。

学习目标

  • 用显式状态描述异步请求的加载、成功与失败阶段
  • 在 Action 内统一处理异常、重试和旧响应竞争
  • 让组件只根据 Store 状态渲染,不重复维护请求状态

把请求生命周期显式化

一个可维护的异步 Store 至少要区分 idle、loading、success、error。数据和错误信息也应由 Store 统一持有,这样页面不用通过“有没有数据”来猜请求是否结束,也不会在多个组件里各自维护一套 loading。

Pinia 异步 Action 的请求状态流转

状态字段的价值在于把“过程”也纳入业务模型。组件可以稳定地把 loading 映射为骨架屏,把 error 映射为错误提示与重试按钮,而不是从 user === null 推断所有情况。

在 Action 中统一收口请求

下面是项目级可运行示例:依赖一个已经安装并启用 Pinia 的 Vue 3 项目,以及真实可用的 GET /api/users/:id 接口。示例使用递增序号忽略过期响应,避免较慢的旧请求覆盖较新的结果。

ts
import { defineStore } from 'pinia'

type User = {
  id: number
  name: string
}

type RequestStatus = 'idle' | 'loading' | 'success' | 'error'

async function requestUser(id: number): Promise<User> {
  const response = await fetch(`/api/users/${id}`)
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`)
  }
  return response.json() as Promise<User>
}

export const useUserStore = defineStore('user', {
  state: () => ({
    user: null as User | null,
    status: 'idle' as RequestStatus,
    errorMessage: '',
    lastUserId: null as number | null,
    requestSeq: 0,
  }),
  actions: {
    async loadUser(id: number) {
      const isNewTarget = this.lastUserId !== id
      const seq = ++this.requestSeq
      this.lastUserId = id
      this.status = 'loading'
      this.errorMessage = ''
      if (isNewTarget) this.user = null

      try {
        const data = await requestUser(id)
        if (seq !== this.requestSeq) return
        this.user = data
        this.status = 'success'
      } catch (error) {
        if (seq !== this.requestSeq) return
        this.status = 'error'
        this.errorMessage =
          error instanceof Error ? error.message : '未知错误'
      }
    },
    async retry() {
      if (this.lastUserId === null || this.status === 'loading') return
      await this.loadUser(this.lastUserId)
    },
  },
})

预期结果

text
成功请求:idle → loading → success,user 更新为接口返回值,errorMessage 为空。
失败请求:loading → error,errorMessage 保存本次异常信息。
调用 retry():error → loading;若接口恢复,则最终进入 success。
较旧请求晚返回:结果被忽略,不会覆盖较新的请求结果。

实际用户 ID、响应内容和错误状态码会随环境变化;需要记录动态值时可使用 <ID>、<VALUE> 等占位符。

让组件只依赖状态

组件层只负责触发 Action 和展示状态,不应再维护第二套 loading、error。否则同一个请求会出现 Store 与组件状态不同步的问题,例如 Store 已失败,但组件仍显示加载中。

渲染规则应保持单向:loading 禁止重复点击并显示加载反馈;error 展示 errorMessage 与重试入口;success 展示数据;idle 保持初始占位。这样请求细节集中在 Store,页面只消费确定的状态契约。

处理重试与并发边界

手动重试通常比无限自动重试更安全。网络抖动需要自动重试时,应设置最大次数、退避间隔,并区分可重试错误与业务错误;例如参数校验失败不应机械重发。

requestSeq 只能解决“旧响应覆盖新响应”,不会真正取消网络请求。若接口开销较大,可进一步使用 AbortController 取消上一请求,但仍建议保留状态序号作为最后一道一致性保护。

把异步 Action 设计成明确的状态机后,加载、失败、重试和并发竞争都能在 Store 内被观察和验证,组件只需要根据状态渲染即可。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

异步 Action 与错误状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通