swagger-api / swagger-api/swagger-codegen

[Java]Maven build failed on maven-javadoc-plugin:2.10.4:jar

Open
#8,959 3 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Mustache
Stars
17.8k
Forks
6k
PR merge metrics
No merged PRs in 30d

Description

Description

Hi folks,

I got an build error when trying to maven install codegen package:

Swagger-codegen version

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar
(attach-javadocs) on project Knowledge.EKG: Execution attach-javadocs of goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar failed:

After googling, I tried different way to get rid of it.

  1. remove .m2 folder
  2. update JDK to latest(11)

However it's still complaining, anyone has any idea what's going on?

Swagger declaration file content or url

This is my Java config when executing jar

"hideGenerationTimestamp": "true",
"sortParamsByRequiredFlag": "true",
"ensureUniqueParams": "true", 
"allowUnicodeIdentifiers": "false",
"artifactVersion": "1.0.0",
"artifactDescription": "###",
"groupId": ###",
"artifactId": "###",
"modelPackage": "###",
"apiPackage": "###",
"invokerPackage" : "###",
"java8": "true",
"developerName": "###",
"developerEmail": "###",
"developerOrganization": "###",
"developerOrganizationUrl": "",
"fullJavaUtil": "false",
"dateLibrary": "java8",
"sourceFolder":  "###"
The block that cause failure in pom.xml
     <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.10.4</version>
            <executions>
                <execution>
                    <id>attach-javadocs</id>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the pom.xml block configuring org.apache.maven.plugins:maven-javadoc-plugin:2.10.4 and reproduce the maven install for the codegen package. The payload does not include the complete failure output or identify a repository file to change, so first determine the specific javadoc error and its scope. Done means establishing a reproducible build result and documenting or correcting the relevant Maven configuration.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
build-system
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.