Cucumber框架下Java通过Webhooks集成Slack收不到通知问题求助

按优先级排查以下问题：

• 参数反序列化异常：你编写的Message类仅提供了text字段的getter方法，没有setter方法，也没有为私有text字段添加@JsonProperty注解，Spring MVC处理@RequestBody时无法将请求JSON中的text值注入到Message对象中，最终发送给Slack的消息中text为null，Slack会直接丢弃空内容的消息。
• 配置匹配异常：USER_TO_CHANNEL_WEBHOOK的key是#channel_name，如果你调用接口时传入的userName路径变量和该key不完全匹配（比如没有带#、大小写不一致、拼写错误），userChannelId会返回null，最终拼接的Slack请求URL无效，同时你当前的代码没有做null校验，也没有捕获RestTemplate请求异常，所以即使Slack请求失败，接口仍然返回200，你感知不到报错。
• 网络访问异常：如果你的服务部署在内网环境，需要配置代理才能访问外网，RestTemplate默认没有走代理的话会无法连通Slack接口，请求超时失败，同样由于没有捕获对应异常，你无法感知到报错。
• Slack侧配置异常：你创建的Slack Webhook应用没有加入到目标频道，或者Webhook的发送权限被关闭，也会导致消息发送失败被Slack拦截。
• 调用链路异常：确认你的Cucumber用例已经正确触发了该接口的调用，可以在Controller方法中添加日志打印入参，确认请求是否正常到达服务端。

修复示例 #

1. 修复Message类 #

public class Message {
    private String text;

    public String getText() {
        return text;
    }

    // 新增setter方法支持反序列化赋值
    public void setText(String text) {
        this.text = text;
    }
}

2. 新增空校验和异常捕获 #

MessageSender类调整

public class MessageSender {
    private static final String HOOKS_URL = "https://hooks.slack.com/services/%s";
    private static final Map<String, String> USER_TO_CHANNEL_WEBHOOK =
            Map.of("#channel_name", "T6TXXXXXX/B02LXXXXXX/YXXXXXXXXXXXXX");
    public void sendMessage(String userName, Message message) throws JsonProcessingException {
        String userChannelId = USER_TO_CHANNEL_WEBHOOK.get(userName);
        // 新增配置空校验
        if (userChannelId == null) {
            throw new IllegalArgumentException("无对应频道的Webhook配置：" + userName);
        }
        String userWebhookUrl = String.format(HOOKS_URL, userChannelId);
        RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        ObjectMapper objectMapper = new ObjectMapper();
        String messageJson = objectMapper.writeValueAsString(message);
        HttpEntity<String> entity = new HttpEntity<>(messageJson, headers);
        // 新增请求异常捕获，可自行添加日志打印排查
        try {
            restTemplate.exchange(userWebhookUrl, HttpMethod.POST, entity, String.class);
        } catch (RestClientException e) {
            throw new RuntimeException("Slack接口请求失败：" + e.getMessage(), e);
        }
    }
}

Controller类调整

@PostMapping(path = "/messages/{userName}", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<String> sendMessage(@PathVariable String userName, @RequestBody Message message) {
    try {
        messageSender.sendMessage(userName, message);
        return ResponseEntity.ok().build();
    } catch (JsonProcessingException | IllegalArgumentException e) {
        return ResponseEntity.badRequest().body(e.getMessage());
    } catch (RuntimeException e) {
        return ResponseEntity.internalServerError().body(e.getMessage());
    }
}

验证步骤 #

1. 先用curl工具直接测试你的Slack Webhook地址是否可用，执行命令：curl -X POST -H 'Content-type: application/json' --data '{"text":"测试消息"}' 你的完整WebhookURL，如果收不到消息优先排查Slack侧配置。
2. 用Postman调用你编写的接口，传入正确的userName和{"text":"测试"}请求体，根据接口返回的错误信息进一步定位问题。
3. 确认服务所在的网络环境可以正常访问Slack的外网地址，没有防火墙或代理限制。

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