# 网页应用远程调试工具使用指南

[网页应用的远程调试工具](https://open.feishu.cn/app/web-inspect)（以下简称调试工具）是飞书开放平台推出的网页应用在线调试工具，在调试页面上可查看应用运行时的 Elements、Console、Network 和 Storage、Cookie 等信息，类似 Chrome devtools。本文档介绍如何使用调试工具。

## 功能概览

调试工具支持的功能有：

- 调试标签和样式
- 打印调试语句、执行命令
- 查看页面 Sources
- 查看网络请求情况
- 查看 Storage、Cookie 等信息

## 环境要求

- **操作系统**：Android、iOS、Windows、Mac
- **飞书版本**：v7.8 及以上版本
- **浏览器**：Chrome
- **网络环境**：网络环境稳定

## 使用步骤

### 建立调试链接

1. 调试平台入口在[开发者后台](https://open.feishu.cn/app) 的 **网页应用** > **网页应用调试工具**，点击 **去调试** 按钮，即可进入调试平台。也可以直接访问[调试平台页](https://open.feishu.cn/app/web-inspect)。
  ![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/0f2b76cce81c42ed1e3ae17020e268bf_70syfhzQpL.png?height=1756&lazyload=true&width=2826)

2. 在调试平台页选择需要调试的网页应用。
	![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/373cf1f975f44a6d3ac0cc46570aa111_fjtD432ysi.png?height=270&lazyload=true&width=1714)

3. 将应用接入调试 JS：将以下脚本内容粘贴到网页应用的<head></head>标签中：

```
    <script src="https://sf1-scmcdn-cn.feishucdn.com/obj/feishu-static/op/fe/devtools_frontend/remote-debug-0.0.1-alpha.6.js"></script>
    ```
    ![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/a5a50daf8c0204be0c0a0111949bbc60_RsNj5xBz3N.png?height=172&lazyload=true&width=1712)

4. 你将看到「桌面端主页地址」和「移动端主页地址」：默认是[开发者后台](https://open.feishu.cn/app) 的 **网页应用** > **在线网页** > 页面填写的「桌面端主页」和「移动端主页」，也可修改成网页应用的子页面地址（要和主页地址在同域名下）。

## 常见问题

**1. 支持自建网页应用调试吗？**

**答**：支持。调试者需要具备自建网页应用的开发者以上权限（开发、管理员、所有者）和应用可见。权限配置见开发者后台 网页应用 > 成员管理。应用可见在开发者后台 网页应用 > 版本管理与发布 > 可见范围。

**2. 引入调试JS，可以发布到线上吗？**

**答**：引入调试JS后，只有在特定的调试状态下才会启用（在调试平台中复制调试地址并打开），普通情况下不会干扰应用的线上运行。

**3. 同一个地址可以同时进行创建多条调试连接吗？**

**答**：每个调试地址在同一个设备上，均有调试连接数量的限制，默认数量为1。

**4. 网络请求时请求头和响应头缺失。**

**答**：请求头缺失与浏览器的安全策略有关。响应头缺失可以看下接口响应头是否配置了Access-Control-Expose-Headers字段。

**5. 测试租户可以调试线上租户的网页应用吗？**

**答**：不可以，测试租户和线上租户数据不通，调试工具不支持**跨租户调试**，请保证调试控制台与调试端应用所在的租户处于同一租户环境内。  