Vue / 系统课时
异步 Action 与错误状态
异步 Action 与错误状态
异步 Action 的重点不是把 fetch 塞进 Store,而是让加载、成功、失败和重试都变成可观察状态。本课用一个用户加载 Store 建立完整请求生命周期,并补上重复请求与旧响应覆盖新数据的边界处理。
学习目标
- 用显式状态描述异步请求的加载、成功与失败阶段
- 在 Action 内统一处理异常、重试和旧响应竞争
- 让组件只根据 Store 状态渲染,不重复维护请求状态
把请求生命周期显式化
一个可维护的异步 Store 至少要区分 idle、loading、success、error。数据和错误信息也应由 Store 统一持有,这样页面不用通过“有没有数据”来猜请求是否结束,也不会在多个组件里各自维护一套 loading。

状态字段的价值在于把“过程”也纳入业务模型。组件可以稳定地把 loading 映射为骨架屏,把 error 映射为错误提示与重试按钮,而不是从 user === null 推断所有情况。
在 Action 中统一收口请求
下面是项目级可运行示例:依赖一个已经安装并启用 Pinia 的 Vue 3 项目,以及真实可用的 GET /api/users/:id 接口。示例使用递增序号忽略过期响应,避免较慢的旧请求覆盖较新的结果。
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)
},
},
})预期结果
成功请求: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 内被观察和验证,组件只需要根据状态渲染即可。