如何解决 Intellij IDEA 无法正确识别 Spring Boot 模板文件中静态资源路径的问题

迈不过友情╰ 2022-01-14 22:41 813阅读 0赞

[2019独角兽企业重金招聘Python工程师标准>>> ][2019_Python_] ![hot3.png][]

默认情况下，Spring Boot 项目中静态资源存放在 `src/main/resources/static`、`src/main/resources/public`、`src/main/resources/resources` 或 `src/main/resources/META-INF/resources`中，模板文件存放在 `src/main/resources/templates` 中。

假设我们的项目中需要用到一个 js 库（这里以 layui 为例），我们将它放入 `src/main/resources/static/jslib` 目录；在模板文件 `src/main/resources/templates/greeting.html` 中我们需要引用 layui.css 和 layui.js，正确的写法如下图所示：

![Intellij IDEA 无法正确识别 Spring Boot 模板文件中静态资源的路径][Intellij IDEA _ Spring Boot]

上图中，`<link rel="stylesheet" href="/jslib/layui/css/layui.css">` 和 `<script src="/jslib/layui/layui.js"></script>` 两行的写法是正确的，如果启动并访问项目，可以观察到资源被正常加载。但 Intellij IDEA 在这里提示 `Cannot resolve controller URL`，按下 Ctrl 键（macOS中是 Command 键）也无法导航到文件。虽然算不上什么大问题，但仍然给我们的开发带来不少麻烦。

那么，这个问题该怎么解决呢？

首先，通过 `File` 菜单打开 `Project Structure` 对话框，从左侧面板选中 `Facets`，在右侧面板中选中 `Web - Web（项目名.main）`（标准的 maven 项目应该都有），如下图所示：

![Project Structure Dialog][]

然后我们在 `Web Resource Directory`中添加两个目录 `src/main/resources/static/` 和 `src/main/resources/templates`，相对于网站根目录都是 `/`，如下图所示：

![Web Resource Directory Sample][]

然后，依次点击 `Apply`、`OK` 按钮关闭 `Project Structure` 对话框。

回到模板文件中，可以观察到，`Cannot resolve controller URL` 的警告已经消失了；试一试，文件导航功能也回来了：

![Intellij IDEA 可以识别到 Spring Boot 模板文件中静态资源的路径了][Intellij IDEA _ Spring Boot 1]

参考文档：

1.  [Spring Boot Reference Guide - 29.1.5 Static Content][]
2.  [Spring Boot Reference Guide - 29.1.10 Template Engines][]
3.  [IntelliJ IDEA Help - Web facet page][]

转载于:https://my.oschina.net/htgylzhq/blog/3015290

[2019_Python_]: https://my.oschina.net/u/2663968/blog/3061697
[hot3.png]: /images/20220114/b96bb253a1d34016bb006fc0efa72567.png
[Intellij IDEA _ Spring Boot]: /images/20220114/33307e4032dd4403b7c798ab3a9147cd.png
[Project Structure Dialog]: /images/20220114/63729a1317b24f918797cd44d9ff81cd.png
[Web Resource Directory Sample]: /images/20220114/b9de40d93ef6486495b6e76fa5621e85.png
[Intellij IDEA _ Spring Boot 1]: /images/20220114/eee8fa7e38484406bb40406fdc6a9cdb.png
[Spring Boot Reference Guide - 29.1.5 Static Content]: https://docs.spring.io/spring-boot/docs/2.1.3.RELEASE/reference/htmlsingle/#boot-features-spring-mvc-static-content
[Spring Boot Reference Guide - 29.1.10 Template Engines]: https://docs.spring.io/spring-boot/docs/2.1.3.RELEASE/reference/htmlsingle/#boot-features-spring-mvc-template-engines
[IntelliJ IDEA Help - Web facet page]: https://www.jetbrains.com/help/idea/web-facet-page.html