- 页面级报错
- 应用场景
- 实现
- 提示性报错
- 应用场景
- 实现
在用户使用过程中,可能遇到各种异常情况,比如页面404,申请结果失败,请求的返回异常等等,这篇文档会按照报错形式的不同,分别介绍下相应的处理建议。
页面级报错
应用场景
- 路由直接引导到报错页面,比如你输入的网址没有匹配到任何页面,可以由路由引导到预设的 404 页面。
- 代码控制跳转到报错页面,比如根据请求返回的数据,将没有权限的用户引导到 403 页面。
实现
针对页面级的报错,我们提供了两个业务组件供你选择,可以很方便地实现一个报错页面:
Exception 异常页
<Exception type="404" />
默认支持 404,403,500 三种错误,也可自定义文案等内容。
Result 结果页
<Result
type="error"
title="提交失败"
description="请核对并修改以下信息后,再重新提交。"
actions={<Button size="large" type="primary">返回修改</Button>}
/>
这个组件一般用在提交结果展示,文案操作等均可自定义。
脚手架默认会将无法匹配到页面的网址引导到预设的 404 页面,如果需要自定义此页面,可以修改这个文件
./src/routes/Exception/404.js
,相关的路由配置在这里 BasicLayout.js#L362
提示性报错
应用场景
- 表单项校验报错。
- 操作反馈。
- 网络请求错误。
实现
关于表单项报错,请参考 antd Form 中的实现。对于操作反馈和网络请求错误提示,有一些组件可能会用到:
- Alert
- message
- notification
在单页应用中,最常见的需求就是处理网络错误信息,我们可以利用 message 和 notification 来吐出响应的接口/网络/业务数据错误。
import fetch from 'dva/fetch';
import { notification } from 'antd';
...
fetch(url)
.then(response => response.json())
.catch((error) => {
// 处理接口返回的数据格式错误的逻辑
if (error.code) {
notification.error({
message: error.name,
description: error.message,
});
}
if ('stack' in error && 'message' in error) {
notification.error({
message: `请求错误: ${url}`,
description: error.message,
});
}
return error;
});
Ant Design Pro 封装了一个 request.js
统一处理请求,完整代码可参考:https://github.com/ant-design/ant-design-pro/blob/master/src/utils/request.js