Main 的 Mock 与请求

Main 使用 apps/backend-mock 的 Nitro 服务。默认执行 pnpm dev:mock，共享 Vite 插件会为所选前端启动 Mock 并把 /api/v1 请求代理到 http://localhost:5320。pnpm dev:mock:api 只启动 5320 端口的独立 Mock API；pnpm dev:backend-mock 是它的别名。Mock 在本地生成响应，不会请求 fast-vue3-server。

服务包含用户登录/资料、角色、菜单、部门、字典、日志、监控和统计等模拟接口。内置账号为 admin / 123456 与 user / 123456。

请求实例

import { createHttpClient, createRequest } from '@fast-vue3/request';
const client = createHttpClient(import.meta.env.VITE_APP_API_BASEURL ?? '/api/v1');
export const http = createRequest(client);

createHttpClient 返回配置好 Token 与 HTTP 错误处理的 Axios 实例，createRequest 提供 get / post / put / del 并解包 { code, message, data }。code !== 0 会抛出包含后端消息的异常。

页面不应直接调用请求实例，而应通过 @fast-vue3/api 的业务域客户端访问接口。这样在 Nitro 与 fast-vue3-server 间切换时不需要改页面代码。

Mock 是开发与集成测试服务，不是生产身份系统。真实后端的启动与切换见真实后端联调。

Mock 与真实服务使用同一鉴权边界：GET /api/v1/public/** 可匿名访问，POST /api/v1/blog/{id}/comments 与 POST /api/v1/payments/checkout 必须登录。集成测试会实际启动 Nitro 监听端口，验证匿名读取、匿名写入 401、登录、评论与创建订单。

企业域路由在 apps/backend-mock/api/v1/[...].ts 中调用内存版 createStaticEnterpriseApi。Nitro 要求 Mock Access Token，多数企业路径仅允许其 admin 模拟账号，但未实现 Java 服务完整的细粒度权限、租户隔离、事务和持久化；浏览器静态预览也使用同一内存实现。业务规则请连接真实后端验证。

七个 site-* 应用的公开内容页面已使用共享门户客户端；web-app 接入首页、特性、关于、博客列表和联系接口。其他六个 web-* 后台的仪表盘、分析、用户和角色页面也使用 API 数据。它们通过 Vite 模式选择 Mock 或 Java，不会通过 Mock 转发到 Java。

源码：apps/backend-mock/api/v1 · 源码：packages/effects/request/src/client.ts

Main 的 Mock 与请求 ​

请求实例 ​

Main 的 Mock 与请求

请求实例