前言：在 UniApp 开发中，若需实现 App 端拉起企业微信并完成内容转发，很多开发者会第一时间想到集成企业微信 SDK，但 SDK 集成步骤繁琐，还需处理原生插件适配问题。本文将分享一种更轻量的方案——无需集成企微 SDK，直接通过 URL Scheme 实现该功能，适合追求快速落地、需求简单的场景。

一、核心原理

企业微信支持通过自定义 URL Scheme 唤起 App 并携带转发参数，UniApp App 端可借助 plus.runtime.openURL() 接口调用该 Scheme，本质是跳转到企业微信的指定页面并传递转发内容（标题、描述、链接、缩略图等）。

关键说明：该方案无需集成企业微信原生 SDK，仅需配置 URL Scheme 参数和企业微信管理端基础信息，集成成本极低，但存在部分限制（无转发状态回调、参数长度有限），适合基础转发需求。

二、前置准备（必做）

实现功能前，需在企业微信管理端完成应用创建和配置，核心是获取「身份凭证」和配置「可信域名」。

1. 登录企业微信管理端

访问 企业微信管理后台，使用企业微信管理员账号登录。

2. 新增移动端应用（核心步骤）

企业微信的所有对外调用都需基于具体应用，我们需创建一个「移动端应用」作为身份载体（无需开发应用功能，仅做配置）：

• 左侧菜单选择「应用管理」→「应用」→「创建应用」；

• 填写基础信息：应用名称（自定义，如「UniApp 转发应用」）、应用类型选择「移动端应用」（必选，适配 App 端调用）、上传图标（可选）；

• 点击「创建」后，在应用详情页获取两个关键参数（后续代码需用到）：

  • corpId：页面顶部的「企业ID」（全局唯一）；

  • agentId：应用详情页的「应用ID」（当前应用唯一）。

3. 配置可信域名（必做，否则转发链接失效）

企业微信会拦截未备案的转发链接，需在应用中配置可信域名：

• 进入应用详情页，找到「开发配置」→「网页授权及JS-SDK」→「设置可信域名」；

• 添加转发链接的域名（如 https://www.example.com），按提示完成域名所有权验证（通常是上传验证文件到域名根目录）；

• 配置完成后，等待 5-10 分钟生效（若未生效，可刷新管理端页面）。

4. 可选配置：移动端权限

在应用详情页「权限管理」→「移动端权限」中，勾选「允许移动端使用」，确保 App 端能正常调用该应用的能力。

三、UniApp 核心代码实现

以下代码可直接复制到 UniApp 项目中使用，核心功能包括：环境校验、企业微信安装检测、URL Scheme 构造、拉起企业微信及失败处理。

1. 完整代码（可直接复用）

/**
 * UniApp App端通过URL Scheme拉起企业微信转发
 * @param {Object} data - 转发参数
 * @param {String} data.title - 转发标题
 * @param {String} data.desc - 转发描述
 * @param {String} data.link - 转发链接（需为可信域名下的链接）
 * @param {String} data.imgUrl - 转发缩略图链接
 */
export function launchWeworkShareByScheme(data) {
  // 1. 校验环境：仅App端支持plus接口
  if (!uni.canIUse('plus')) {
    uni.showToast({
      title: '仅支持App端使用该功能',
      icon: 'none',
      duration: 2000
    });
    return;
  }

  try {
    // 2. 构造URL Scheme参数（需编码特殊字符）
    const schemeParams = {
      corpId: '你的企业ID（corpId）', // 替换为第一步获取的corpId
      title: encodeURIComponent(data.title || '默认转发标题'),
      desc: encodeURIComponent(data.desc || '默认转发描述'),
      link: encodeURIComponent(data.link || 'https://你的可信域名.com'), // 替换为已配置的可信域名链接
      imgUrl: encodeURIComponent(data.imgUrl || 'https://默认缩略图链接.png') // 可选，建议用小尺寸图片
    };

    // 3. 企业微信转发固定URL Scheme格式
    const weworkScheme = `wwopen://wxwork/sendmsg?corpId=${schemeParams.corpId}&title=${schemeParams.title}&desc=${schemeParams.desc}&link=${schemeParams.link}&imgUrl=${schemeParams.imgUrl}`;

    // 4. 调用URL Scheme拉起企业微信
    plus.runtime.openURL(weworkScheme, 
      (successRes) => {
        console.log('拉起企业微信成功', successRes);
        // 注意：此处仅能确认拉起成功，无法判断用户是否完成转发
      }, 
      (errorRes) => {
        console.error('拉起企业微信失败', errorRes);
        // 失败处理：通常是未安装企业微信，引导下载
        uni.showModal({
          title: '提示',
          content: '未检测到企业微信，是否前往下载？',
          confirmText: '前往下载',
          cancelText: '取消',
          success: (res) => {
            if (res.confirm) {
              // 跳转到企业微信官方下载页
              plus.runtime.openURL('https://work.weixin.qq.com/');
            }
          }
        });
      }
    );
  } catch (err) {
    console.error('企业微信转发出错', err);
    uni.showToast({
      title: '转发失败，请重试',
      icon: 'none',
      duration: 2000
    });
  }
}

// 调用示例（在需要转发的页面调用）
// import { launchWeworkShareByScheme } from '@/utils/wework-share.js';
// launchWeworkShareByScheme({
//   title: 'UniApp 转发测试',
//   desc: '无需SDK，通过URL Scheme实现企业微信转发',
//   link: 'https://www.example.com', // 已配置的可信域名链接
//   imgUrl: 'https://www.example.com/logo.png'
// });
}

2. 代码关键说明

• 环境校验：通过 uni.canIUse('plus') 判断是否为 App 端，避免在 H5/小程序端无效调用；

• 参数编码：使用 encodeURIComponent() 编码标题、描述等参数，防止特殊字符（如空格、中文）导致 Scheme 解析失败；

• Scheme 格式：企业微信转发的固定 Scheme 为 wwopen://wxwork/sendmsg，后续拼接所需参数即可；

• 失败处理：若拉起失败（多数是未安装企业微信），通过弹窗引导用户前往官方下载页。

四、关键注意事项（避坑指南）

1. 参数长度限制：URL Scheme 总长度通常不超过 2048 字符，建议转发的标题、描述简洁，缩略图用小尺寸图片（如 200x200px）；

2. 无转发状态回调：该方案仅能判断是否成功拉起企业微信，无法获取用户最终是否完成转发（若需此功能，需改用 SDK 方案）；

3. iOS 特殊配置：iOS 端需在 info.plist 中配置企业微信的 Scheme 白名单（添加 wwopen），否则可能无法拉起；

4. ios配置示例（manifest.json 源码视图）：：

   "ios" : {
       "dSYMs" : false,
       "plist" : {
           "LSApplicationQueriesSchemes" : [
               "wwopen"  // 企业微信 Scheme 白名单
           ],
           "CFBundleURLTypes" : [
               {
                   "CFBundleURLSchemes" : [
                       "wwopen"
                   ]
               }
           ]
       }
   },

5. 可信域名校验：转发链接必须是已配置的可信域名，且需带 https 协议，否则转发后链接无法打开；

6. 企业微信版本：建议提醒用户更新企业微信到最新版本，避免旧版本不支持 Scheme 转发参数。

五、方案优缺点总结

优点

• 集成简单：无需集成企业微信 SDK，无需处理原生插件适配，复制代码即可快速落地；

• 轻量无依赖：不增加项目体积，适合小需求场景；

• 配置步骤少：仅需在企业微信管理端创建应用和配置可信域名。

缺点

• 无转发状态回调：无法知道用户是否成功转发，仅能确认是否拉起企业微信；

• 功能有限：仅支持基础文本+链接+缩略图转发，无法实现复杂转发需求（如转发文件、自定义转发类型）；

• 依赖 Scheme 稳定性：企业微信可能随版本调整 Scheme 格式，需关注官方动态。

六、适用场景

该方案适合对转发功能要求不高、追求快速落地的场景，例如：

• 简单的内容分享（如文章、活动链接转发）；

• 内部办公类 App，仅需在企业微信内流转内容；

• 原型验证、小项目快速上线需求。

七、常见问题排查

1. 问题：拉起企业微信后无转发内容？ 排查：检查 corpId 是否正确、转发链接是否为可信域名、参数是否编码；

2. 问题：iOS 端无法拉起企业微信？ 排查：检查 info.plist 中是否配置 wwopen 白名单，企业微信是否为最新版本；

3. 问题：转发后链接无法打开？ 排查：可信域名是否配置正确、链接是否带 https 协议、域名是否完成所有权验证；

4. 问题：参数传递后乱码？ 排查：确保所有字符串参数都通过 encodeURIComponent() 编码。

5. 企微得通过认证

结语

本文分享的 URL Scheme 方案，是 UniApp App 端拉起企业微信转发的轻量解决方案，无需集成 SDK，适合简单需求场景。若你的项目需要更完整的功能（如转发状态回调、复杂内容转发），建议后续切换到企业微信 SDK 方案。如果在配置或使用过程中遇到问题，可在评论区留言交流！

附：企业微信官方 URL Scheme 文档（可查阅最新参数格式）