Spring Config Server无法通过Webhook刷新问题求助

问题分析 #

你遇到的400 Bad Request错误，根源在于GitHub Webhook推送的JSON Payload结构和/actuator/bus-refresh端点的期望不匹配：

• GitHub Webhook发送的是包含commits数组的复杂JSON对象（比如错误日志里提到的commits字段是数组类型）
• 但/actuator/bus-refresh端点默认只接受无请求体或者简单字符串类型的请求体，Jackson在尝试将数组反序列化为String时抛出了类型不匹配异常。

而用Postman或curl能成功，是因为你发送的是空请求体的POST请求，刚好符合端点的要求。

解决方案 #

下面提供三种可行的解决办法，你可以根据自己的场景选择：

方案1：调整GitHub Webhook配置（最简单）

直接修改GitHub仓库的Webhook设置，让它发送bus-refresh能处理的请求：

• 打开GitHub仓库的「Settings」→「Webhooks」页面，找到你的Webhook
• 将Content type从application/json改为application/x-www-form-urlencoded
• 清空Payload输入框（或者随便填一个简单字符串，比如refresh）
• 点击「Update webhook」保存设置

之后再推送代码到GitHub，Webhook就能正常触发配置刷新了。

方案2：自定义中转Controller处理Webhook请求

如果不想修改Webhook的Content-Type配置，可以写一个简单的中转Controller，接收GitHub的完整Payload后，内部调用bus-refresh端点：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

@RestController
public class GitHubWebhookRefreshController {

    private final RestTemplate restTemplate;

    // 注入RestTemplate，若项目未配置需先定义对应的Bean
    public GitHubWebhookRefreshController(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    @PostMapping("/github-webhook-refresh")
    public ResponseEntity<Void> handleWebhook() {
        // 调用bus-refresh，无需传递请求体
        restTemplate.postForObject("http://localhost:8080/actuator/bus-refresh", null, Void.class);
        return new ResponseEntity<>(HttpStatus.OK);
    }
}

然后把GitHub Webhook的Payload URL改成http://436d3d0b.ngrok.io/github-webhook-refresh，Content-Type保持application/json即可。

方案3：添加过滤器忽略bus-refresh的请求体

如果你想保留原有的/actuator/bus-refresh端点，又不想修改Webhook配置，可以添加一个过滤器，拦截Webhook的请求并清空请求体：

import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class BusRefreshRequestFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        // 仅针对bus-refresh端点处理
        if ("/actuator/bus-refresh".equals(httpRequest.getRequestURI())) {
            chain.doFilter(new EmptyBodyRequestWrapper(httpRequest), response);
        } else {
            chain.doFilter(request, response);
        }
    }

    // 自定义请求包装类，返回空输入流
    private static class EmptyBodyRequestWrapper extends HttpServletRequestWrapper {
        public EmptyBodyRequestWrapper(HttpServletRequest request) {
            super(request);
        }

        @Override
        public ServletInputStream getInputStream() throws IOException {
            return new ServletInputStream() {
                @Override
                public boolean isFinished() { return true; }
                @Override
                public boolean isReady() { return true; }
                @Override
                public void setReadListener(ReadListener listener) {}
                @Override
                public int read() throws IOException { return -1; } // 表示流已结束
            };
        }
    }
}

这个过滤器会在请求到达bus-refresh端点前，将请求体替换为空，避免Jackson解析出错。

验证 #

完成任意一种方案的配置后，推送代码到GitHub，检查Webhook的状态应该显示「200 OK」，同时所有订阅配置的服务会自动刷新配置。

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