maven打包提示警告: @param 没有说明

我不是女神ヾ 2023-10-10 08:29 43阅读 0赞

在JDK 1.8环境下使用

maven-javadoc-plugin  
打包时，遇到错误：  
\[ERROR\] /Users/Documents/workspace/git/x/qautil/src/main/java/com/t/qaforest/db/forestdb/stdcategory/CategoryPropertyValuesDB.java:104: 警告: valueId没有 @param  
\[ERROR\] public static void updateFields(long categoryId, long propertyId, long valueId, Map<String, Object> fieldMap) \{  
\[ERROR\] ^  
\[ERROR\] /Users/Documents/workspace/git/x/-qautil/src/main/java/com/t/qaforest/db/forestdb/stdcategory/StdCategoryPropertyValuesDB.java:100: 警告: @param 没有说明  
\[ERROR\] \* @param categoryId  
\[ERROR\] ^  
\[ERROR\] /Users/d/Documents/workspace/git/x/x-qautil/src/main/java/com/t/qaforest/db/forestdb/stdcategory/StdCategoryPropertyValuesDB.java:101: 警告: @param 没有说明  
\[ERROR\] \* @param fieldMap  
\[ERROR\] ^  
\[ERROR\] /Users/d/Documents/workspace/git/x/x-qautil/src/main/java/com/t/qaforest/db/forestdb/stdcategory/StdCategoryPropertyValuesDB.java:103: 警告: propertyId没有 @param  
\[ERROR\] public static void updateFields(long categoryId, long propertyId, long valueId, Map<String, Object> fieldMap) \{  
\[ERROR\] ^  
\[ERROR\] /Users/d/Documents/workspace/git/x/x-qautil/src/main/java/com/t/qaforest/db/forestdb/stdcategory/StdCategoryPropertyValuesDB.java:103: 警告: valueId没有 @param  
\[ERROR\] public static void updateFields(long categoryId, long propertyId, long valueId, Map<String, Object> fieldMap) \{  
\[ERROR\] ^  
\[ERROR\] /Users/d/Documents/workspace/git/x/x-qautil/src/main/java/com/t/qaforest/localForest/BuilderUtil.java:22: 警告: @param 没有说明  
\[ERROR\] \* @param paramName

处理：

在pom plugin中，加上下面配置，排除

<plugin>   
        <groupId>org.apache.maven.plugins</groupId>    
        <artifactId>maven-javadoc-plugin</artifactId>    
        <version>2.8</version>    
        <executions>   
          <execution>   
            <id>attach-javadocs</id>    
            <goals>   
              <goal>jar</goal>   
            </goals>    
            <configuration>   
              <additionalparam>-Xdoclint:none</additionalparam>   
            </configuration>   
          </execution>   
        </executions>   
     </plugin>

之后打包报错： MavenReportException: Error while creating archive: Unable to find javadoc command: The environment variable JAVA\_HOME is not correctly set.

关键错误信息：

\[ERROR\] MavenReportException: Error while creating archive: Unable to find javadoc command: The environment variable JAVA\_HOME is not correctly set.  
1  
解决办法：  
http://blog.softur.pl/2013/02/11/fail-to-execute-javadoc-plugin-on-mac-osx-java\_home-issue/

在pom.xml文件properties节点添加属性

<javadocExecutable>$\{java.home\}/../bin/javadoc</javadocExecutable>  
1  
此方法虽然管用，但是只是临时的，需要对每个项目都进行添加。

需要添加一个系统变量，待完善。  
问题产生的原因应该是，mvn拿到的javaHome位置应该是$\{JAVA\_HOME\}/jre而不是jdk位置