如何从另一应用调用自建微服务的POST请求接口？

嘿，针对你要从另一个应用调用这个POST接口的需求，我给你整理了几种在Java/Spring生态下常用的实现方案，都是项目里实际在用的：

先贴一下你的原接口代码方便参考：

@PostMapping("/create")
public ResponseEntity<?> createUser(@RequestBody User user) {
    //执行其他操作，比如校验
    someService.createUser(user);
    URI location = ...;
    return ResponseEntity.created(location).build();
}

这是Spring早期就支持的同步HTTP客户端，适合简单的同步场景：

首先在调用方的Spring配置里注册RestTemplate Bean：

@Configuration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

然后在业务类里注入并调用接口：

@Service
public class UserServiceClient {
    private final RestTemplate restTemplate;

    // 构造注入（推荐方式）
    public UserServiceClient(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    public URI callCreateUserApi(User user) {
        try {
            // 设置请求头，指定JSON格式
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            
            // 封装请求体和头
            HttpEntity<User> requestEntity = new HttpEntity<>(user, headers);
            
            // 发送POST请求，接收响应
            ResponseEntity<Void> response = restTemplate.postForEntity(
                "http://www.example.com/create",
                requestEntity,
                Void.class
            );
            
            // 提取原接口返回的Location头信息
            return response.getHeaders().getLocation();
        } catch (HttpStatusCodeException e) {
            // 处理请求失败的情况，比如400参数错误、500服务异常
            throw new RuntimeException("调用创建用户接口失败，状态码：" + e.getStatusCode(), e);
        }
    }
}

如果你的调用方是响应式应用（比如用Spring WebFlux），或者想更高效的异步调用，WebClient是更好的选择：

先配置WebClient Bean：

@Configuration
public class WebClientConfig {
    @Bean
    public WebClient webClient() {
        return WebClient.builder()
                .baseUrl("http://www.example.com") // 设置基础地址，后续调用只需写路径
                .defaultHeader(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE)
                .build();
    }
}

然后编写调用逻辑：

@Service
public class ReactiveUserClient {
    private final WebClient webClient;

    public ReactiveUserClient(WebClient webClient) {
        this.webClient = webClient;
    }

    // 返回Mono<URI>，支持响应式编程
    public Mono<URI> createUserReactively(User user) {
        return webClient.post()
                .uri("/create") // 相对于baseUrl的路径
                .bodyValue(user) // 直接传入请求体，自动序列化为JSON
                .exchangeToMono(response -> {
                    if (response.statusCode().is2xxSuccessful()) {
                        // 成功时提取Location头
                        return response.headers().location();
                    } else {
                        // 失败时抛出异常
                        return response.createException().flatMap(Mono::error);
                    }
                })
                .onErrorMap(WebClientResponseException.class, e -> 
                    new RuntimeException("调用创建用户接口失败：" + e.getStatusCode(), e)
                );
    }
}

• 如果你的调用方不是Spring应用，也可以用OkHttp、Apache HttpClient这类第三方HTTP客户端，核心逻辑都是：构造POST请求→设置Content-Type为application/json→序列化User对象为JSON字符串作为请求体→发送请求并处理响应。
• 要确保调用方和服务端的User类结构完全一致（字段名、类型都匹配），避免JSON序列化/反序列化出错。
• 如果是跨环境调用，要确认目标服务的地址是可访问的（比如测试环境、生产环境的域名/IP是否正确）。

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