Overview

主要使用使用Maven自动生成项目站点的一些坑。

List

• maven-site-plugin 插件需要使用3.3版本，如果使用3.2，由于兼容性问题可能在site阶段报错。

• Eclipse中启动mvn site阶段找不到JAVA_HOME：
  报错信息如下：

   Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9.1:jar (attach-javadocs) on project suppress-warnings: MavenReportException: Error while creating archive: Unable to find javadoc command: The environment variable JAVA_HOME is not correctly set.
  

  已经在本地的配置中设置了JAVA_HOME：

   export JAVA_HOME=$(/usr/libexec/java_home)
  

  在命令行运行 mvn clean site:site， javadoc 可以找到JAVA_HOME，但是在eclipse中执行maven构建，还是会报一样的错误，这是由于，在本地设置的JAVA_HOME不能被A bundled GUI app like Eclipse识别，需要在全局配置中添加该信息。
  找到/etc/launchd.conf文件，如果该目录不存在这个文件，sudo vim launchd.conf创建改文件，必须使用sudo，不然无法写入该文件，添加一行：

   setenv JAVA_HOME /Library/Java/JavaVirtualMachines/jdk1.8.0_25.jdk/Contents/Home
  

  注意：不能使用

   setenv JAVA_HOME $(/usr/libexec/java_home) 
  

  这样的小技巧，否则，这里不能识别这种写法。

  保存，并重启电脑，配置生效。