Java17+SpringBoot3 API路径映射失败，Postman报HTTP解析错误

错误原因 #

你请求的地址localhost:3306/api/cadastrar-pj存在端口错误：3306是MySQL数据库的服务端口，并非Spring Boot应用的HTTP服务端口。Postman尝试向数据库端口发送HTTP请求，无法解析HTTP协议，因此抛出"Parse Error: Expected HTTP/"。

修复步骤 #

• 修正请求地址：将端口替换为Spring Boot应用的端口（默认是8080），正确地址应为localhost:8080/api/cadastrar-pj。若你在application.properties/application.yml中自定义了端口（如server.port=9090），则使用对应端口。
• 配置Postman请求：确保请求方法为POST，请求头添加Content-Type: application/json，请求体JSON格式保持你提供的内容即可：

{
    "nome": "Armando A. M. Vidal",
    "email": "armandoamvidal@gmail.com",
    "senha": "123456",
    "cpf": "44433322211",
    "razaoSocial": "Armando Ltda",
    "cnpj": "12345678912345"
}

• 验证接口映射：检查Controller类的注解配置，确保@PostMapping路径与请求地址匹配，示例代码：

@RestController
@RequestMapping("/api")
public class PjCadastroController {
    @PostMapping("/cadastrar-pj")
    public ResponseEntity<?> cadastrarPessoaJuridica(@RequestBody PessoaJuridicaDto dto) {
        // 实现新增数据库逻辑
        return ResponseEntity.ok("Cadastro concluído");
    }
}

• 确认应用状态：检查Spring Boot启动日志，确保应用正常启动、数据库连接无异常，接口已被正确注册。

额外排查 #

• 若仍报错，检查Postman是否开启了代理，或误选了非HTTP协议（如WebSocket）。
• 查看Spring Boot请求日志，确认请求是否到达服务器，排查是否存在路径映射错误。

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