问题描述:

最近公司换spring boot 做微服务开发。多个微服务按模块导入导入到idea。之前是单独的项目导入。能正常启动和正常访问。换到idea的项目--模块结构之后。发现用内置tomcat启动web项目无法访问到jsp页面了。(ps:打成war包到外面tomcat启动是没有问题。只是不服,发现这个奇葩的问题没找到原因心中不爽。)

问题分析:

无法访问jsp,很自然想到:一是路径有没有映射对?二是文件不存在。检查一遍之后发现映射没有问题,文件也存在。这就比较奇葩了。唯有看一下springboot在启动的时候如何定义web root的路径。跟一下springboot的tomcat启动包的源码:

/**
 * Returns the absolute document root when it points to a valid directory, logging a
 * warning and returning {@code null} otherwise.
 * @return the valid document root
 */
protected final File getValidDocumentRoot() {
   File file = getDocumentRoot();
   // If document root not explicitly set see if we are running from a war archive
   file = file != null ? file : getWarFileDocumentRoot();
   // If not a war archive maybe it is an exploded war
   file = file != null ? file : getExplodedWarFileDocumentRoot();
   // Or maybe there is a document root in a well-known location
   file = file != null ? file : getCommonDocumentRoot();
   if (file == null && this.logger.isDebugEnabled()) {
      this.logger
            .debug("None of the document roots " + Arrays.asList(COMMON_DOC_ROOTS)
                  + " point to a directory and will be ignored.");
   }
   else if (this.logger.isDebugEnabled()) {
      this.logger.debug("Document root: " + file);
   }
   return file;
}

发现有三种取路径方式。war包 getWarFileDocumentRoot,导出包 getExplodedWarFileDocumentRoot,和文档 getCommonDocumentRoot。内置tomcat启动应该属于第三种。跟进去第三种发现:

private static final String[] COMMON_DOC_ROOTS = { "src/main/webapp", "public",
      "static" };

private File getCommonDocumentRoot() {
   for (String commonDocRoot : COMMON_DOC_ROOTS) {
      File root = new File(commonDocRoot);
      if (root != null && root.exists() && root.isDirectory()) {
         return root.getAbsoluteFile();
      }
   }
   return null;
}

 写死从上面配置的3个目录去取doc路径。看到这里问题就明了。关键是 

File root = new File(commonDocRoot);
if (root != null && root.exists() && root.isDirectory()) {
   return root.getAbsoluteFile();
}

File root = new File("src/main/webapp") 的是 这个相对路径的前缀是取哪里的。百度得知取的是

System.getProperty("user.dir")

相当于 File root = new File(System.getProperty("user.dir")+"src/main/webapp");

然后 debug 打印一下 System.getProperty("user.dir") 发现 是定位到了 项目那层 而不是模块那层

解决方法:

既然发现了问题,解决就简单。这里采用的是直接在启动项里面增加配置参数$MODULE_DIR$

将"user.dir" 定位到模块里面

 

springboot多模块项目 模块之间调用 springboot多模块项目怎么启动_spring

问题解决

最后:因为对tomcat的启动顺序不了解。跟这个过程的时候走了不少弯路。采用了最笨的方法,在后面层层倒推一直找到上面设置doc路径的方法。如果熟悉原理,直接从开始就定位到那个方法就很快能解决了。所以记录下来。避免自己或有遇到同样问题的人少走弯路。

此时再次访问能跳转jsp页面url,会发现jsp页面已经能成功渲染出来了,而且再次翻看C:\Users\{用户名}\AppData\Local\Temp中最新生成的tomcat目录内容,能看到已经编译出jsp的相关文件了:

springboot多模块项目 模块之间调用 springboot多模块项目怎么启动_tomcat_02