SpringBoot应用实现向钉钉发送带图片的消息的两种方法总结_Java

在spring boot应用中向钉钉发送带图片的消息，主要有两种主流实现方式：一种是使用机器人webhook发送包含图片链接的消息，另一种是通过钉钉开放平台sdk发送图片消息。下面我为你详细说明这两种方法的实现步骤。

两种发送钉钉图片消息的方案对比

方案类型	实现方式	图片处理	适用场景	主要限制
机器人webhook方案	通过群机器人webhook发送图文消息	图片需先上传至公网可访问的url	群聊通知、监控告警	图片需公网可访问；每分钟限20条
钉钉sdk方案	使用官方sdk上传媒体文件并发送	图片上传至钉钉服务器获取media_id	企业内部应用、精确到人	需要企业应用权限；流程更复杂

方案一：使用钉钉机器人webhook发送图文消息

这是最常用和简便的方法，适合向钉钉群发送带图片的通知消息。

1. 创建钉钉群机器人

首先需要在钉钉群中创建自定义机器人：

进入钉钉群设置 → 智能群助手 → 添加机器人 → 自定义
记录生成的webhook地址和加签密钥（如有安全设置）

2. 添加maven依赖

根据不同的starter库，可以选择以下依赖之一：

<!-- 方案a: snowheart的starter -->
<dependency>
    <groupid>cn.snowheart</groupid>
    <artifactid>spring-boot-dingtalk-robot-starter</artifactid>
    <version>1.0.3.release</version>
</dependency>

<!-- 方案b: javafamily的starter -->
<dependency>
    <groupid>club.javafamily</groupid>
    <artifactid>dingtalk-notification-spring-boot-starter</artifactid>
    <version>2.3.2-beta.13</version>
</dependency>

3. 配置webhook参数

在application.yml中配置机器人信息：

# 如果使用snowheart的starter
dingtalk:
  robot:
    prefix: https://oapi.dingtalk.com/robot/send
    access-token: your_access_token_here
    secret:
      secret-enabled: true
      secret-token: your_secret_here

# 如果使用javafamily的starter  
javafamily:
  notify:
    dingtalk:
      hook-url: https://oapi.dingtalk.com/robot/send?access_token=your_token
      enabled: true

4. 实现图片消息发送

以下是几种常见的带图片消息类型的实现代码：

a. 发送link消息（图片+标题+描述）

@restcontroller
public class dingtalkcontroller {
    
    @autowired
    private dingtalkrobotclient dingtalkrobotclient; // snowheart starter
    
    /**
     * 发送带图片的link消息
     */
    @getmapping("/sendlinkmessage")
    public void sendlinkmessagewithimage() {
        // 图片必须先上传到公网可访问的url
        string imageurl = "https://example.com/your-image.jpg";
        string title = "系统监控告警";
        string text = "服务器cpu使用率超过90%，请及时处理！";
        string messageurl = "http://your-system.com/detail"; // 点击跳转链接
        
        linkmessage linkmessage = new linkmessage(title, text, imageurl, messageurl);
        dingtalkresponse response = dingtalkrobotclient.sendlinkmessage(linkmessage);
        
        if (response.geterrcode().longvalue() == 0l) {
            system.out.println("link消息发送成功");
        }
    }
}

b. 发送markdown消息（图片嵌入正文）

/**
 * 发送markdown格式的图片消息
 */
@getmapping("/sendmarkdownwithimage")
public void sendmarkdownwithimage() {
    string imageurl = "https://example.com/chart.png";
    
    string markdowntext = "### 业务数据报表\n\n" +
                         "最新业务数据统计图如下：\n\n" +
                         "![业务图表](" + imageurl + ")\n\n" +
                         "**统计时间：** " + new date();
    
    markdownmessage markdownmessage = new markdownmessage(
        "业务数据通知", 
        markdowntext
    );
    
    dingtalkresponse response = dingtalkrobotclient.sendmarkdownmessage(markdownmessage);
    
    if (response.geterrcode().longvalue() == 0l) {
        system.out.println("markdown消息发送成功");
    }
}

c. 使用javafamily starter发送消息

@springboottest
public class dingtalknotifytests {
    
    @autowired
    private dingtalknotifyhandler dingtalknotifyhandler; // javafamily starter
    
    @test
    void testnotifylinkmessage() {
        string imageurl = "https://example.com/image.jpg";
        
        dingtalklinkrequest request = dingtalklinkrequest.of(
            "系统通知",
            "发现异常请求，请及时查看处理",
            "https://your-system.com/detail",
            imageurl
        );
        
        string response = dingtalknotifyhandler.notify(request);
        system.out.println("发送结果：" + response);
    }
}

方案二：使用钉钉官方sdk发送图片消息

这种方法适合企业内部应用，需要用户授权，可以发送给指定用户。

1. 添加官方sdk依赖

<dependency>
    <groupid>com.aliyun</groupid>
    <artifactid>alibaba-dingtalk-service-sdk</artifactid>
    <version>2.0.0</version>
</dependency>

2. 实现图片上传和发送

@component
public class dingtalkservice {
    
    @value("${dingding.app-key}")
    private string appkey;
    
    @value("${dingding.app-secret}")
    private string appsecret;
    @value("${dingding.agent-id}")
    private long agentid;
    
    /**
     * 获取accesstoken
     */
    public string getaccesstoken() throws apiexception {
        dingtalkclient client = new defaultdingtalkclient("https://oapi.dingtalk.com/gettoken");
        oapigettokenrequest request = new oapigettokenrequest();
        request.setappkey(appkey);
        request.setappsecret(appsecret);
        request.sethttpmethod("get");
        
        oapigettokenresponse response = client.execute(request);
        return response.getaccesstoken();
    }
    
    /**
     * 上传图片并发送
     */
    public void sendimagemessage(string userid, string imageurl) throws apiexception {
        string accesstoken = getaccesstoken();
        
        // 1. 先上传图片获取media_id
        string mediaid = uploadimage(accesstoken, imageurl);
        
        // 2. 发送图片消息
        dingtalkclient client = new defaultdingtalkclient(
            "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2");
        
        oapimessagecorpconversationasyncsendv2request req = new oapimessagecorpconversationasyncsendv2request();
        req.setagentid(agentid);
        req.setuseridlist(userid);
        
        oapimessagecorpconversationasyncsendv2request.msg msg = 
            new oapimessagecorpconversationasyncsendv2request.msg();
        msg.setmsgtype("image");
        
        msg.setimage(new oapimessagecorpconversationasyncsendv2request.image());
        msg.getimage().setmediaid(mediaid);
        
        req.setmsg(msg);
        
        oapimessagecorpconversationasyncsendv2response rsp = client.execute(req, accesstoken);
        if (rsp.geterrcode() != 0) {
            throw new runtimeexception("发送失败：" + rsp.geterrmsg());
        }
    }
    
    /**
     * 上传图片到钉钉服务器
     */
    private string uploadimage(string accesstoken, string imageurl) throws apiexception {
        dingtalkclient client = new defaultdingtalkclient("https://oapi.dingtalk.com/media/upload");
        oapimediauploadrequest request = new oapimediauploadrequest();
        request.settype("image");
        
        // 需要下载图片并上传
        fileitem item = new fileitem(new url(imageurl).openstream());
        request.setmedia(item);
        
        oapimediauploadresponse response = client.execute(request, accesstoken);
        return response.getmediaid();
    }
}

重要注意事项

图片处理要点

图片url必须公网可访问：钉钉机器人需要从公网下载图片进行展示
图片格式支持：支持jpg、png等常见格式，建议图片大小不超过2mb
图片缓存：钉钉会对图片进行缓存，相同url的图片可能不会实时更新

安全限制

频率限制：每个机器人每分钟最多发送20条消息
安全设置：支持自定义关键词、加签、ip白名单等安全措施
token保护：webhook中的access_token要妥善保管，避免泄露

实际应用示例：监控告警带图表

@service
public class monitoralertservice {
    
    @autowired
    private dingtalkrobotclient dingtalkrobotclient;
    
    public void sendalertwithchart(string alertmsg, string chartimageurl) {
        string markdowncontent = "### 🚨 系统监控告警\n\n" +
                               "**告警信息：** " + alertmsg + "\n\n" +
                               "**趋势图表：** \n\n" +
                               "![监控图表](" + chartimageurl + ")\n\n" +
                               "**时间：** " + new simpledateformat("yyyy-mm-dd hh:mm:ss").format(new date());
        
        markdownmessage message = new markdownmessage("系统监控告警", markdowncontent);
        
        // @所有人
        message.setisatall(true);
        
        dingtalkresponse response = dingtalkrobotclient.sendmarkdownmessage(message);
        
        if (response.geterrcode() == 0) {
            system.out.println("告警消息发送成功");
        }
    }
}