Vue 中异步数据加载与方法调用顺序问题：`await` 的正确使用

在 Vue 项目中，我们经常需要在页面加载时获取异步数据，并在数据加载完成后调用方法进行后续操作。然而，如果异步方法没有正确返回 Promise，可能会导致方法调用顺序出现问题。本文将通过一个实际案例，分析问题的原因并提供解决方案。

问题描述

在一个 Vue 项目中，我们需要在页面加载时获取经营概况数据，并在数据加载完成后绘制图表。代码如下：

const getBusinessOverviewData = () => {getBusinessOverview().then(res => {console.log('获取饼图数据', res);const result = res.data.data;businessData.value = result;});
};onMounted(async () => {await nextTick();// 获取饼图数据await getBusinessOverviewData();// 绘制图表drawCharts();
});

然而，在实际运行中发现，drawCharts 方法总是在 getBusinessOverviewData 数据加载完成之前被调用，导致图表绘制失败。

问题原因

1. 异步方法未返回 `Promise`

在 getBusinessOverviewData 方法中，虽然使用了 then 处理异步操作，但方法本身没有显式返回 Promise。因此，await getBusinessOverviewData() 实际上是立即完成的，而不会等待异步操作完成。

2. `await` 的行为

await 只能等待一个 Promise。如果方法没有返回 Promise，await 会立即完成，后续代码会继续执行。

解决方案

方法 1：显式返回 `Promise`

在 getBusinessOverviewData 方法中，显式返回 Promise，确保 await 能正确等待异步操作完成。

const getBusinessOverviewData = () => {return getBusinessOverview().then(res => {console.log('获取饼图数据', res);const result = res.data.data;businessData.value = result;});
};onMounted(async () => {await nextTick();// 获取饼图数据await getBusinessOverviewData();// 绘制图表drawCharts();
});

方法 2：使用 `async/await` 重写异步方法

使用 async/await 重写 getBusinessOverviewData 方法，使代码更加简洁和易读。

const getBusinessOverviewData = async () => {const res = await getBusinessOverview();console.log('获取饼图数据', res);const result = res.data.data;businessData.value = result;
};onMounted(async () => {await nextTick();// 获取饼图数据await getBusinessOverviewData();// 绘制图表drawCharts();
});

完整示例

以下是完整的代码示例，展示了如何正确处理异步数据加载与方法调用顺序。

import { ref, onMounted, nextTick } from 'vue';
import * as echarts from 'echarts';const businessData = ref(null);const getBusinessOverviewData = async () => {const res = await getBusinessOverview();console.log('获取饼图数据', res);const result = res.data.data;businessData.value = result;
};const drawCharts = () => {if (businessData.value) {console.log('绘制饼图', businessData.value);// 绘制图表逻辑} else {console.warn('businessData 尚未加载完成，跳过绘制图表');}
};onMounted(async () => {await nextTick();await getBusinessOverviewData();drawCharts();
});

总结

在 Vue 项目中，正确处理异步数据加载与方法调用顺序是非常重要的。以下是一些关键点：

确保异步方法返回 Promise：
- 如果方法中使用了 then，需要显式返回 Promise。
- 使用 async/await 可以让代码更加简洁和易读。
await 的行为：
- await 只能等待一个 Promise，如果方法没有返回 Promise，await 会立即完成。