SpringBootのREST APIで、curlでJSONを送ると415エラー（Unsupported Media Type）

Question

Kotlinサーバーサイド実践開発という本のREST APIの実装部分を行っております。

以下を記載し、動作させ、curlコマンドでJSONを送り、JSONが返る想定ですがエラーが返ります。

@RestController
@RequestMapping("greeter")
class GreeterController {
    // JSONでリクエストを受け取る
    @PostMapping("/hello")
    fun helloByPost(@RequestBody request: HelloRequest): HelloResponse {
        return HelloResponse("Hello ${request.name}")
    }

    // リクエストリングでリクエストを受け取る
    @GetMapping("/hello")
    fun hello(@RequestParam("name") name: String): HelloResponse {
        return HelloResponse("Hello ${name}")
    }
}

data class HelloRequest(val name: String)

data class HelloResponse(val message: String)

コマンドプロンプトで実行したコマンド

curl -H 'Content-Type:application/json' -X POST -d '{"name":"Kotlin"}' http://localhost:8080/greeter/hello

返ってきたエラーメッセージ

{"timestamp":"2021-10-16T02:49:19.075+00:00","status":415,"error":"Unsupported Media Type","message":"","path":"/greeter/hello"}

2021-10-16 12:07:24.097  WARN 13840 --- [nio-8080-exec-3] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'application/x-www-form-urlencoded;charset=UTF-8' not supported]

hello()は想定通りの動作をしており、URLの間違いはなさそうです。
エラーで調べていくと、
Content-Type: application/jsonとapplicationの前にスペースが入る、'と"が違う、など多少の表記揺れがあり、試してみましたが結果は変わりませんでした。
コマンドプロンプトの設定はshift-JISでしたので、サポートしていないと出ているUTF-8でないので、ここが原因ではないかと思っています。
Windows10で、intellijで作成していますが、本の作者はMacで行っているそうです。

お手数おかけしますが、原因、解決方法お判りになりませんでしょうか？
よろしくお願いいたします。

Comments

[退会済みユーザー]

Fiddler などのパケットキャプチャツールを使って要求・応答を調べてみませんか。要求ヘッダが Content-Type:application/json になっているかどうかとか。エラーメッセージを見ると application/x-www-form-urlencoded;charset=UTF-8 になっているように見えますけど。

[666_paru]

ありがとうございます。
原因がわかりまして、ダブルクォーテーションにエスケープが必要でした。

Fiddlerを知らなかったため、今度から使用して検証してみます。
教えて頂き、ありがとうございます。

Answer 1

Fiddler の Composer を使ってはいかがですか？

このように URL、POST メソッド、Content-Type、送信する JSON 文字列を設定して Execute ボタンをクリックするれば送信されます。

結果の要求・応答は Inspectors タブをクリックして見ることができます。

Comments

[666_paru]

Fiddler の Composerというものは知りませんでした。教えて頂きありがとうございます。

先ほど今回の原因がわかりまして、ダブルクォーテーションにエスケープが必要なためエラーになっておりました。

この調べ方には今後もお世話になると思います。教えて頂きありがとうございます！

[退会済みユーザー]

Fiddler が開発に有用なのは Composer の機能だけでなく、2 枚目の画像にある要求・応答の内容が分かることです。curl、ブラウザ、自作アプリなど HTTP 通信を行うクライアントなら何でもキャプチャできます。トラブルがあったとき要求・応答が分からないと解決できないことも多々あります。是非導入されることをお勧めします。

今回のトラブルも 2 枚目の画像の要求を見れば原因がすぐ分かったと思います。(curl で Fiddler を使うには、curl のオプションでプロキシを通すようにすればキャプチャしてくれます)

[IT001]

Fiddler良いツールですよね。Spring Boot+ RESTの開発現場だと、PostmanやSwagger UIがよく使われています。
https://stackshare.io/stackups/fiddler-vs-postman-vs-swagger-ui
Postmanはシェアが高いのと、Spring BootだとSwagger UIは依存関係に追加するだけで使えてしまうので便利です。
いずれにしても、Fiddler、Postman、Swagger UIはとても良いツールだと思います。

Answer 2

Windowsであれば、ダブルクォーテーションを使うので、以下で取得できます。（掲載して頂いたSpring Boot + Kotlinのコードも、動作することを確認しました）

curl -H "Content-Type:application/json" -X POST -d "{\"name\":\"Kotlin\"}" http://localhost:8080/greeter/hello

Comments

[666_paru]

教えて頂きありがとうございます！
ダブルクォーテーションにしてエスケープが必要だったのですね。
動作することを確認できました。