Microsoft Office加载项中MySQL Node.js驱动对象为Null的排查求助

你遇到的核心问题是环境不兼容：Microsoft Office加载项的任务窗格（taskpane）是运行在浏览器/WebView上下文里的，而mysql Node.js驱动是专门为Node.js服务器环境设计的，它依赖Node.js专属的模块（比如net、fs），这些在浏览器环境里根本不存在，所以直接在taskpane.js里导入会失败，导致mysql对象为null。

哪怕你给webpack设置了target: 'node'也没用——因为Office加载项的前端最终还是要在WebView里运行，这个配置只会让打包后的代码更偏向Node.js环境，反而和浏览器环境冲突。

你需要搭建一个独立的Node.js后端API服务，用它来连接MySQL数据库，然后Office加载项的前端通过HTTP请求调用这个API来操作数据库。具体步骤如下：

1. 搭建Node.js后端服务 #

• 新建一个Node.js项目，初始化后安装所需依赖：

  npm init -y
  npm install mysql express cors
  npm install --save-dev nodemon
  

• 编写后端代码（比如server.js），实现数据库操作接口：

  const express = require('express');
  const mysql = require('mysql');
  const cors = require('cors');
  const app = express();
  
  // 允许跨域请求（解决Office加载项和后端的跨域问题）
  app.use(cors());
  // 解析JSON请求体
  app.use(express.json());
  
  // 配置MySQL连接
  const db = mysql.createConnection({
    host: '你的数据库地址',
    user: '数据库用户名',
    password: '数据库密码',
    database: '目标数据库名'
  });
  
  // 测试数据库连接
  db.connect(err => {
    if (err) {
      console.error('数据库连接失败:', err);
      return;
    }
    console.log('成功连接到MySQL');
  });
  
  // 示例接口：获取数据库数据
  app.get('/api/get-data', (req, res) => {
    db.query('SELECT * FROM 你的表名', (err, results) => {
      if (err) {
        return res.status(500).json({ error: err.message });
      }
      res.json(results);
    });
  });
  
  // 启动服务
  const PORT = 3000;
  app.listen(PORT, () => {
    console.log(`后端服务运行在 http://localhost:${PORT}`);
  });
  

2. 修改Office加载项前端代码 #

• 移除taskpane.js里的import { mysql } from 'mysql';语句，卸载前端项目里的相关依赖：

  npm uninstall mysql @types/mysql
  

• 把webpack.config.js里的target: 'node'删除，恢复默认的web环境打包配置。
• 用HTTP请求调用后端API，示例代码：

  async function fetchDataFromDB() {
    await Word.run(async (context) => {
      try {
        // 调用后端API获取数据
        const response = await fetch('http://localhost:3000/api/get-data');
        if (!response.ok) throw new Error('请求失败');
        const data = await response.json();
        
        // 将数据插入Word文档
        context.document.body.insertParagraph(`数据库返回数据：${JSON.stringify(data)}`, Word.InsertLocation.end);
      } catch (error) {
        context.document.body.insertParagraph(`错误：${error.message}`, Word.InsertLocation.end);
      }
      await context.sync();
    });
  }
  

3. 额外注意事项 #

• 生产环境中，不要把数据库密码硬编码在代码里，用环境变量（比如dotenv包）管理敏感信息。
• 如果Office加载项是HTTPS部署的，后端服务也需要配置HTTPS，否则会被浏览器的安全策略阻止（开发阶段可以临时允许混合内容，但生产环境必须用HTTPS）。
• 后端部署后，要把前端请求的地址从localhost:3000改成实际的公网服务器地址。

内容的提问来源于stack exchange，提问作者Paul Kaplan