RuoYi-Vue-Pro 项目中表单设计器 Select 组件数据自动授权方案解析

背景介绍

在 RuoYi-Vue-Pro 项目中，使用表单设计器创建流程表单时，Select 组件需要从后端接口获取数据。但当前系统存在一个技术痛点：当 Select 组件配置的接口需要授权头(Authorization header)时，无法自动添加认证信息，导致接口调用失败。

问题分析

在项目实践中，开发者发现以下技术难点：

1. 表单设计器中的 Select 组件配置了需要权限验证的后端接口
2. 这些接口默认需要 Authorization header 才能正常访问
3. 当前解决方案要么将接口改为免认证(@PermitAll)，要么需要手动处理认证逻辑

解决方案

经过技术探索，项目团队提出了以下两种解决方案：

方案一：重写 formCreate.fetch 方法

通过在 src/plugins/formCreate/index.ts 中重写 fetch 方法，可以统一处理所有表单设计器发出的请求：

const overrideFetch = (option: any, effectArgs: any) => {
  service({
    url: option.action,
    method: option.method,
    data: option.data,
    headers: option.headers,
    withCredentials: option.withCredentials
  })
    .then((res) => {
      try {
        if (option._parse) {
          const parseFn = formCreate.parseFn(option._parse)
          res.data = parseFn(res)
        }
      } catch (e) {
        console.log('--parseFn error--', e)
      }
      option.onSuccess?.(res)
    })
    .catch((e) => {
      option.onError?.(e)
    })

  return option
}

然后在 setupFormCreate 函数中覆盖默认的 fetch 实现：

export const setupFormCreate = (app: App<Element>) => {
  components.forEach((component) => {
    app.component(component.name, component)
  })
  formCreate.use(install)
  formCreate.fetch = overrideFetch
  app.use(formCreate)
  app.use(FcDesigner)
}

方案二：使用 form-create 的 options.beforeFetch 配置

form-create 官方文档提供了 beforeFetch 方法，可以在请求前处理规则，例如设置 token。这种方式更加灵活，可以针对特定请求进行定制化处理。

技术实现细节

1. 请求拦截机制：通过重写 fetch 方法，实现了对所有表单设计器请求的统一拦截
2. 认证信息注入：利用项目中已有的 service 封装，自动携带认证信息
3. 数据解析处理：保留了原有的数据解析功能(_parse)，确保业务逻辑不受影响
4. 错误处理：完善了请求成功和失败的回调处理

注意事项

在实际使用中，开发者还发现了一个相关问题：表单设计器中 Select 组件的解析函数保存功能存在问题。具体表现为：

1. 修改解析函数并保存后，再次编辑时无法显示之前保存的解析函数
2. 通过 Vue 调试工具可以看到参数确实存在，但界面无法正确显示

这个问题已被项目团队记录并正在解决中，建议开发者关注后续更新。

总结

RuoYi-Vue-Pro 项目通过重写表单设计器的 fetch 方法，优雅地解决了 Select 组件调用需要认证接口的问题。这种方案具有以下优势：

1. 统一处理所有请求，减少重复代码
2. 自动携带认证信息，提高开发效率
3. 保持原有功能不受影响
4. 便于后续维护和扩展

对于需要类似功能的开发者，可以参考此方案进行实现，同时注意关注项目中可能存在的其他相关问题的修复进展。