maven-checkstyle-plugin:3.0.0初始化StrictDuplicateCode模块失败求助

Let's break down how to resolve this error when running the maven-checkstyle-plugin:3.0.0:check goal on your abc-123-micro-service project. The root issue is that the plugin can't find the implementation class for the StrictDuplicateCode module you're trying to use. Here are the most common fixes:

1. Correct the Module Name in Your Checkstyle Config #

First, double-check your Checkstyle XML configuration. The valid class name for this duplicate code check is StrictDuplicateCodeCheck (not StrictDuplicateCode). Checkstyle uses the suffix Check for most rule classes, and the error message even hints at this by listing StrictDuplicateCodeCheck as a failed instantiation attempt.

Update your config to use the correct module name:

<module name="StrictDuplicateCodeCheck">
    <!-- Add your desired configuration properties here -->
    <property name="minLines" value="15"/> <!-- Example: Minimum lines to flag as duplicate -->
</module>

If you prefer using the full canonical class name for clarity, you can write it as:

<module name="com.puppycrawl.tools.checkstyle.checks.duplicates.StrictDuplicateCodeCheck">
    <!-- Your properties -->
</module>

2. Ensure the Plugin Has the Right Checkstyle Dependency #

The maven-checkstyle-plugin:3.0.0 defaults to using Checkstyle 8.0, which does include StrictDuplicateCodeCheck, but sometimes dependency conflicts or missing jars can cause the class to not be found. To fix this, explicitly declare the Checkstyle dependency within the plugin configuration to guarantee you're using a compatible, complete version:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-checkstyle-plugin</artifactId>
            <version>3.0.0</version>
            <dependencies>
                <!-- Use a newer, stable 8.x version of Checkstyle (compatible with the plugin) -->
                <dependency>
                    <groupId>com.puppycrawl.tools</groupId>
                    <artifactId>checkstyle</artifactId>
                    <version>8.45.1</version>
                </dependency>
            </dependencies>
            <executions>
                <execution>
                    <id>default-check</id>
                    <goals>
                        <goal>check</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Avoid using Checkstyle 9.x or higher with this plugin version, as 9.x requires Java 11+ and isn't compatible with maven-checkstyle-plugin:3.0.0.

3. Verify No Outdated Extensions Are Conflicting #

In older Checkstyle versions, StrictDuplicateCode was a separate extension module. If your project has any old dependencies for Checkstyle extensions, remove them—this rule is now part of the core Checkstyle library, so separate extensions will cause conflicts.

To debug dependency issues further, run the Checkstyle goal with debug logging to see exactly which jars are being loaded:

mvn checkstyle:check -X

Look for lines related to com.puppycrawl.tools.checkstyle.checks.duplicates.StrictDuplicateCodeCheck to confirm the class is present in the classpath.

After making these changes, re-run mvn checkstyle:check—the error should be resolved if you've addressed the root cause.

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