Vue / 系统课时
接口 Mock 与联调切换
接口 Mock 与联调切换
前后端并行开发时,页面不能因为真实接口尚未完成而停工;进入联调后,又不能让 Mock 逻辑散落在组件里。本节用统一服务接口和环境开关隔离两套数据源,使调用方无需改代码即可在 Mock 与真实 API 之间切换。
学习目标
- 用统一服务契约隔离 Mock 与真实请求实现
- 通过环境变量选择数据源而不修改组件
- 建立切换后的验证清单,避免 Mock 行为掩盖真实接口问题
先固定调用契约
Mock 和真实实现必须遵守同一 TypeScript 接口。组件只依赖 UserService,不知道数据来自本地数组还是 HTTP,这样联调时只替换实现,不修改页面调用方式。

下面示例把切换点收敛到工厂函数。RealUserService 使用标准 fetch,MockUserService 返回同结构数据,两者都实现同一接口。
type User = {
id: string
name: string
}
interface UserService {
list(): Promise<User[]>
}
class MockUserService implements UserService {
async list(): Promise<User[]> {
return [
{ id: 'u-1', name: 'Mock Alice' },
{ id: 'u-2', name: 'Mock Bob' },
]
}
}
class RealUserService implements UserService {
constructor(private readonly baseUrl: string) {}
async list(): Promise<User[]> {
const response = await fetch(`${this.baseUrl}/users`)
if (!response.ok) {
throw new Error(`HTTP ${response.status}`)
}
return response.json() as Promise<User[]>
}
}
function createUserService(mode: 'mock' | 'real', baseUrl: string): UserService {
return mode === 'mock'
? new MockUserService()
: new RealUserService(baseUrl)
}
async function main() {
const service = createUserService('mock', 'https://api.example.com')
console.log(await service.list())
}
main().catch(console.error)预期输出
[
{ id: 'u-1', name: 'Mock Alice' },
{ id: 'u-2', name: 'Mock Bob' }
]切到 real 模式后,实际输出取决于后端 /users 响应;此时应以接口契约和网络请求结果为准,不再期待固定的 Mock 数据。
用环境变量控制切换
在 Vite 项目中,可以把选择条件放进环境文件,而不是手改源码。下面是片段示例,依赖前面的 createUserService、UserService 与对应实现。
const apiMode = import.meta.env.VITE_API_MODE === 'real' ? 'real' : 'mock'
const userService = createUserService(
apiMode,
import.meta.env.VITE_API_BASE_URL,
)
export { userService }开发 Mock 环境可以设置:
VITE_API_MODE=mock
VITE_API_BASE_URL=http://localhost:<PORT>联调环境改为:
VITE_API_MODE=real
VITE_API_BASE_URL=http://localhost:<PORT><PORT> 替换为实际后端端口。Vite 在启动或构建时读取对应环境文件,因此修改变量后应重新启动开发服务器,再验证当前模式是否生效。
让 Mock 模拟真实约束
高质量 Mock 不只返回“成功数据”。至少要覆盖空列表、字段缺失策略、分页边界、权限失败和服务器错误,否则页面可能只在联调阶段才暴露加载态、错误态和空状态问题。
Mock 数据应遵守真实接口契约,不要为了页面方便私自添加只有前端认识的字段。若页面需要额外字段,应通过适配层转换,而不是污染 Mock DTO,这样 Mock 与真实接口才能真正互换。
联调切换时怎么验收
切换到真实接口后,先确认 Network 中的请求地址、方法和状态码,再检查响应是否经过与 Mock 相同的适配流程。随后重点验证加载、空数据、错误、权限和分页等状态,而不只是“列表能显示”。
如果需要多人并行开发,可让默认本地环境使用 Mock,而专门的联调环境使用真实 API;两边共用同一服务契约和页面模型。这样 Mock 的职责只是提供可替换的数据源,真正的业务代码不会因为联调阶段到来而被重写。