在Docker-Wechatbot-Webhook项目中发送本地图片的技术实现

原创于 2025-06-06 09:19:27 发布 · 345 阅读

6 ·

CC 4.0 BY-SA版权

在Docker-Wechatbot-Webhook项目中发送本地图片的技术实现

发送本地图片到微信是一个常见的需求场景，但在实际开发过程中可能会遇到各种技术挑战。本文将以Docker-Wechatbot-Webhook项目为例，详细介绍如何正确实现本地图片的发送功能。

常见问题分析

在尝试发送本地图片时，开发者通常会遇到以下几类问题：

文件路径格式错误：直接使用file://协议或裸路径都会导致URL解析失败
文件类型处理不当：未正确处理文件类型会导致微信客户端无法识别
文件名丢失：传输过程中丢失文件名信息会导致接收方显示为"undefined"

解决方案详解

正确的文件发送方式

要实现本地图片的发送，需要使用Buffer格式结合FormData进行传输。以下是关键实现步骤：

使用Node.js的fs模块读取文件为Buffer
创建FormData实例并正确设置文件字段
确保设置正确的Content-Type头部

代码实现示例

import * as fs from 'fs';
import * as FormData from 'form-data';

// 读取文件为Buffer
const fileBuffer = fs.readFileSync('/path/to/image.png');

// 创建FormData实例
const formData = new FormData();
formData.append('to', '接收方ID');
formData.append('isRoom', '0'); // 0表示个人，1表示群组
formData.append('content', fileBuffer, {
  filename: 'image.png', // 必须指定文件名
  contentType: 'image/png' // 必须指定内容类型
});

// 发送请求
axios.post('http://localhost:3001/webhook/msg?token=YOUR_TOKEN', formData, {
  headers: {
    'Content-Type': 'multipart/form-data',
  },
});