Jackson Cannot construct instanceの直し方

Cannot construct instance of ... (no Creators, like default constructor, exist) は、JSON から Java のオブジェクトを作るときに、Jackson がそのクラスの作り方（コンストラクタ）を見つけられなかったときの例外です。

エラー文の後半（: のあと）で、原因が分かります。

確認環境：Jackson 2.14（jackson-databind 2.14.0、jackson-module-parameter-names 2.14.2）、OpenJDK 21 で再現しました（確認日 2026年10月11日）。

原因① 引数なしのコンストラクタが無い（一番多い）

public static class NoDefault {
    public final int id;
    public final String name;
    public NoDefault(int id, String name) { this.id = id; this.name = name; }
}
om.readValue("{\"id\":1,\"name\":\"a\"}", NoDefault.class);

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of `N$NoDefault` (no Creators, like default constructor, exist): cannot deserialize from Object value (no delegate- or property-based Creator)

jackson-annotations の README では、Jackson は既定で引数なしのコンストラクタを使ってオブジェクトを作り、別のコンストラクタを使うには @JsonCreator が必要と説明されています。 引数ありのコンストラクタしか無いと、どの引数に JSON のどの項目を入れればよいか分からず、この例外になりました。

public static class WithCreator {
    public final int id;
    public final String name;
    @JsonCreator
    public WithCreator(@JsonProperty("id") int id, @JsonProperty("name") String name) {
        this.id = id; this.name = name;
    }
}

final のフィールドを使い、不変のクラスにしたいときは、@JsonCreator か record が向いています。

ParameterNamesModule は -parameters が必要

ParameterNamesModule は、コンパイルのときに -parameters を付けて、引数の名前を class ファイルに残したときだけ効きました。 「ある環境では動き、別の環境では動かない」ときは、ビルドの設定で -parameters が付いているかを確かめます。

原因② static でない内部クラス

public class N {
    public class Inner { public int id; public Inner() {} }    // static が無い
}

Cannot construct instance of `N$Inner`: non-static inner classes like this can only by instantiated using default, no-argument constructor

static でない内部クラスは、外側のクラスのオブジェクトが無いと作れないため、引数なしのコンストラクタを書いていても失敗しました。 JSON 用のクラスを別のクラスの中に書くときは、public static class にします。テストのコードで起きやすい形です。内部クラスの違いは、既存の記事「Java内部クラス・staticネスト・匿名クラスの違い比較表」で扱っています。

原因③ インターフェース・抽象クラス

Cannot construct instance of `N$Shape` (no Creators, like default constructor, exist): abstract types either need to be mapped to concrete types, have custom deserializer, or contain additional type information

readValue(json, Shape.class) の Shape がインターフェースや抽象クラスだと、どの具体的なクラスを作ればよいか分かりません。 変換先には具体的なクラスを指定します。JSON によって作るクラスを変えたいときは、@JsonTypeInfo・@JsonSubTypes で JSON に型の情報を持たせる方法が、jackson-annotations の README で紹介されています。

原因④ JSON の形が違う（although at least one Creator exists）

although at least one Creator exists は「作り方はあるが、この形の JSON からは作れない」という意味です。リストのつもりが文字列1つ、オブジェクトのつもりが文字列、といった JSON の形の違いを確かめます。文字列1つのコンストラクタだけのクラスは、"X1" のような文字列の JSON からは作れました。

確認の手順（チェックリスト）

よくある質問

Q. Lombok の @Value や @AllArgsConstructor のクラスでも起きますか。 A. 引数ありのコンストラクタだけになる場合は、同じ原因で起きる可能性があります。Lombok が作るコードは、既存の記事「Lombokアノテーション一覧｜展開後コードと使い分け早見表」で確かめられます。

Q. JSON に知らない項目があるときのエラーは。 A. 関連記事の「Jackson UnrecognizedPropertyExceptionの直し方」で扱っています。

まとめ

• JSON からオブジェクトを作る方法（コンストラクタ）が見つからない例外
• エラー文の後半で原因が分かる（no delegate・non-static・abstract・although）
• 引数ありだけのクラスは @JsonCreator＋@JsonProperty か record
• 内部クラスは static を付ける
• ParameterNamesModule は -parameters でコンパイルしたときだけ効く

参考・出典

確認日はいずれも 2026年10月11日です。

• FasterXML「jackson-annotations」README（@JsonCreator・@JsonTypeInfo）：https://github.com/FasterXML/jackson-annotations

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。