Pinia 的 getters 必须是同步纯函数，不能处理异步逻辑；应通过 actions 预加载数据并更新 state，再由 getters 基于 state 同步计算派生状态，组件中先调用 action 再响应式使用 getter。
Pinia 的 getters 本身不能直接处理异步逻辑，因为它们必须是同步的纯函数——这是响应式系统的基础要求。你无法在 getter 中 await、返回 Promise 或触发网络请求。但实际业务中常需要“基于异步数据的派生状态”，比如“用户是否已认证”“订单能否发货（需查库存接口）”。这类需求有清晰、推荐的替代方案。
用 actions 预加载 + getters 做同步判断
把异步操作交给 actions，把结果存入 state；getter 只负责基于已有 state 做快速计算。
- 在 action 中调用 API 获取数据，并更新 state（如
user、isLoaded、error） - getter 不接触 Promise，只读取 state 字段并返回确定值
- 组件中先调用 action 加载，再响应式地使用 getter
示例：
store/user.store.ts
export const useUserStore = defineStore('user', {<br> state: () => ({<br> profile: null as User | null,<br> isLoading: false,<br> error: null as string | null<br> }),<br> actions: {<br> async fetchProfile() {<br> this.isLoading = true;<br> try {<br> const data = await api.getUser();<br> this.profile = data;<br> } catch (err) {<br> this.error = '加载失败';<br> } finally {<br> this.isLoading = false;<br> }<br> }<br> },<br> getters: {<br> isPremium(): boolean {<br> return !!this.profile?.subscription?.isActive;<br> },<br> displayName(): string {<br> return this.profile?.name || '游客';<br> }<br> }<br>});
在组件中组合异步状态与派生逻辑
当需要更细粒度控制（比如按需触发、带参数、多条件组合），不建议强行塞进 store，而应在组件或组合函数中用 computed + ref 封装。
- 用
ref存储异步结果（如const orderStatus = ref）(null) - 用
computed基于该 ref 和其他响应式数据生成新状态 - 必要时配合
watchEffect触发重新加载
这样既保持 getter 的纯粹性，又让异步逻辑更灵活、可测试、易调试。
避免常见误区
以下写法不可行或高风险：
-
在 getter 中 return async function：返回的是 Promise，不是响应式值，模板里显示为
[object Promise] - 在 getter 中 await 调用 action：会阻塞响应式求值，且多次调用可能引发重复请求或竞态问题
- 用 storeToRefs 解构 getter 返回的 Promise：解构后失去响应性，也无法 await
-
把 loading 状态硬编码进 getter 判断：如
isLoading ? '...' : this.data—— 这会让 getter 失去缓存意义，每次访问都重算
