◀ 2.

Error creating bean with name 'org.springframework.aop.confi

▶
この記事の要点
  • AOP を有効にしたとき、Spring が AOP 用の内部 Bean(internalAutoProxyCreator)を作れずに起動が止まるエラー
  • 「Could not initialize class」は、そのクラスの初期化が以前に一度失敗しているという意味。本当の原因はログのもっと上にある
  • 典型原因 1: AspectJ のライブラリ(aspectjweaver)がクラスパスにない
  • 典型原因 2: spring-aop だけ別バージョンにするなど、Spring の各モジュールのバージョンが混在している
  • 対処: Spring の全モジュールを同じバージョンにそろえ(BOM を使う)、aspectjweaver を追加する。Spring Boot ならスターターを使う
  • 「spring-aop は 3.1 以下で使う」は根本対処ではない。古いバージョンに固定せず、バージョンをそろえる

エラー内容

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.aop.config.internalAutoProxyCreator': Instantiation of bean failed; nested exception is java.lang.NoClassDefFoundError: Could not initialize class org.springframework.aop.aspectj.annotation.AnnotationAwareAspectJAutoProxyCreator

発生条件

AOP の使用時、具体的には XML 設定の <aop:aspectj-autoproxy/> や Java 設定の @EnableAspectJAutoProxy で @Aspect ベースの AOP を有効にしたアプリの起動時に発生します。Spring はこの設定を見つけると、内部的に org.springframework.aop.config.internalAutoProxyCreator という名前で AnnotationAwareAspectJAutoProxyCreator の Bean を作ろうとします。このクラスのロードに失敗すると、上のエラーでアプリケーションコンテキスト全体の起動が止まります。

原因:「Could not initialize class」の意味

NoClassDefFoundError には 2 つの形があり、意味が違います。

メッセージ意味
NoClassDefFoundError: org/aspectj/...(スラッシュ区切りのクラス名)そのクラスファイル自体がクラスパスに見つからない
NoClassDefFoundError: Could not initialize class ...クラスは見つかったが、初回の初期化(static 初期化)が失敗済みで、2 回目以降の利用で出る

今回は後者なので、最初に失敗したときの例外が同じログのもっと上に出ているはずです。ExceptionInInitializerError や、org/aspectj/... を含む最初の NoClassDefFoundError を探すと、本当の原因が分かります。

AnnotationAwareAspectJAutoProxyCreator は AspectJ のクラスを利用するため、よくある原因は次の 2 つです。

  1. AspectJ のライブラリがない: spring-aop だけを依存に入れ、aspectjweaver を入れていない
  2. Spring のモジュール間でバージョンが混在: 例えば spring-context や spring-core は 3.0 系のまま、spring-aop だけ新しいバージョンにした。モジュール同士は同じバージョンで組み合わせる前提なので、内部のクラスやメソッドが見つからず初期化に失敗する

旧版の本記事では「参考書の記述をまねて spring-aop だけ最新(3.1 以上)にしたら発生した」「3.1 以下で使う」と書いていましたが、これは 2 の「バージョン混在」に当たると考えられます。spring-aop を古くすると他のモジュールとたまたま合うため直ったように見えますが、根本対処は全モジュールのバージョンをそろえることです。

対処法

1. Spring の全モジュールのバージョンをそろえる(Maven)

個別にバージョンを書くとずれやすいので、Spring Framework の BOM(部品表)を読み込み、各モジュールのバージョン指定を省略します。

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-framework-bom</artifactId>
      <version>使用する Spring のバージョン</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-aop</artifactId>
  </dependency>
</dependencies>

2. AspectJ のライブラリを追加する

<dependency>
  <groupId>org.aspectj</groupId>
  <artifactId>aspectjweaver</artifactId>
  <version>使用する Spring・Java に対応したバージョン</version>
</dependency>

aspectjweaver には aspectjrt の内容も含まれるため、通常は weaver だけで足ります。AspectJ のバージョンが古すぎると、新しい Java(クラスファイル形式)を読めずに初期化で失敗することがあるので、実行する Java のバージョンに対応したものを選びます。

3. Spring Boot の場合はスターターを使う

Spring Boot では、バージョン管理をスターターに任せるのが確実です。

  • Spring Boot 3 系まで: spring-boot-starter-aop
  • Spring Boot 4 系: spring-boot-starter-aspectj に名称変更

スターターを使っている場合は、spring-aop や aspectjweaver に個別のバージョンを書かない(Boot の管理するバージョンを上書きしない)ようにします。

確認方法

  1. Maven なら mvn dependency:tree、Gradle なら gradle dependencies で依存関係の木を出力する
  2. org.springframework のモジュールがすべて同じバージョンか確認する(他ライブラリ経由で古い spring-aop が入り込んでいないか)
  3. org.aspectj:aspectjweaver が含まれているか確認する
  4. WAR を Tomcat などに配置している場合は、WEB-INF/lib や サーバー共通の lib に古い Spring の JAR が残っていないかも確認する
  5. Eclipse では「Maven → プロジェクトの更新」を行ってから再起動し、ログの最初の例外を見直す

落とし穴

  • ログの最後だけを見ない: 「Could not initialize class」は二次的なエラー。最初の例外を探さないと原因を取り違える
  • 手動で JAR を配置した環境: Maven を使わず JAR をコピーした古いプロジェクトでは、同じライブラリの複数バージョンが混在しやすい
  • 参考書・古い記事のバージョンをそのまま使わない: 一部だけ最新にすると混在が起きる。プロジェクト全体のバージョン方針を決めてそろえる

関連

Post Share
子ページ

子ページはありません

同階層のページ
  1. java.lang.IllegalStateException: CGLIB is required to process @Configuration classes
  2. Error creating bean with name 'org.springframework.aop.config.internalAutoProxyCreator': Instantiation of bean failed; nested exception is java.lang.NoClassDefFoundError: Could not initialize class org.springframework.aop.aspectj.annotation.AnnotationAwareAspectJAutoProxyCreator
  3. No mapping found for HTTP request with URI ... in DispatcherServlet with name ...
  4. An internal error occurred during: "Building UI model". com/google/common/base/Function
  5. No identifier specified for entity : ...
  6. org.hibernate.hql.internal.ast.QuerySyntaxException: table_name is not mapped
  7. No compiler is provided in this environment
  8. java.sql.SQLException: The server time zone value ' ... ' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone
  9. Caused by: java.lang.RuntimeException: Executing an update/delete query
  10. Not supported for DML operations
  11. Field ... required a bean of type ... that could not be found.
  12. Annotation-specified bean name 'xxxController' for bean class [com.xxx.controller.xxxController] conflicts with existing, non-compatible bean definition of same name and class [com.xxx.xxxController]
  13. Whitelabel Error Page This application has no explicit mapping for /error, so you are seeing this as a fallback.
  14. Exception in thread "main" java.lang.UnsupportedClassVersionError