Vue / 系统课时

接口 Mock 与联调切换

接口 Mock 与联调切换

前后端并行开发时,页面不能因为真实接口尚未完成而停工;进入联调后,又不能让 Mock 逻辑散落在组件里。本节用统一服务接口和环境开关隔离两套数据源,使调用方无需改代码即可在 Mock 与真实 API 之间切换。

学习目标

  • 用统一服务契约隔离 Mock 与真实请求实现
  • 通过环境变量选择数据源而不修改组件
  • 建立切换后的验证清单,避免 Mock 行为掩盖真实接口问题

先固定调用契约

Mock 和真实实现必须遵守同一 TypeScript 接口。组件只依赖 UserService,不知道数据来自本地数组还是 HTTP,这样联调时只替换实现,不修改页面调用方式。

Mock 与真实 API 共用同一服务契约

下面示例把切换点收敛到工厂函数。RealUserService 使用标准 fetch,MockUserService 返回同结构数据,两者都实现同一接口。

ts
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)

预期输出

text
[
  { id: 'u-1', name: 'Mock Alice' },
  { id: 'u-2', name: 'Mock Bob' }
]

切到 real 模式后,实际输出取决于后端 /users 响应;此时应以接口契约和网络请求结果为准,不再期待固定的 Mock 数据。

用环境变量控制切换

在 Vite 项目中,可以把选择条件放进环境文件,而不是手改源码。下面是片段示例,依赖前面的 createUserService、UserService 与对应实现。

ts
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 环境可以设置:

text
VITE_API_MODE=mock
VITE_API_BASE_URL=http://localhost:<PORT>

联调环境改为:

text
VITE_API_MODE=real
VITE_API_BASE_URL=http://localhost:<PORT>

<PORT> 替换为实际后端端口。Vite 在启动或构建时读取对应环境文件,因此修改变量后应重新启动开发服务器,再验证当前模式是否生效。

让 Mock 模拟真实约束

高质量 Mock 不只返回“成功数据”。至少要覆盖空列表、字段缺失策略、分页边界、权限失败和服务器错误,否则页面可能只在联调阶段才暴露加载态、错误态和空状态问题。

Mock 数据应遵守真实接口契约,不要为了页面方便私自添加只有前端认识的字段。若页面需要额外字段,应通过适配层转换,而不是污染 Mock DTO,这样 Mock 与真实接口才能真正互换。

联调切换时怎么验收

切换到真实接口后,先确认 Network 中的请求地址、方法和状态码,再检查响应是否经过与 Mock 相同的适配流程。随后重点验证加载、空数据、错误、权限和分页等状态,而不只是“列表能显示”。

如果需要多人并行开发,可让默认本地环境使用 Mock,而专门的联调环境使用真实 API;两边共用同一服务契约和页面模型。这样 Mock 的职责只是提供可替换的数据源,真正的业务代码不会因为联调阶段到来而被重写。

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

目录与阅读设置

阅读设置

17

记录一个想法

接口 Mock 与联调切换

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

登录哪都通