Springboot 第二讲 属性配置及访问静态资源

本文深入解析SpringBoot项目中默认及自定义配置方法,包括修改访问端口、路径,多环境配置,自定义属性读取,实体类属性赋值,静态资源访问配置,以及WebJars的使用。

1、项目默认属性配置文件所在位置及配置实例

创建Spring Boot项目时,会默认生成一个全局配置文件application.properties(修改后缀为.yml)
【修改默认配置】在application.yml中操作

1.修改访问端口号
server:
#  设置访问端口号
  port: 8080
2.默认访问路径为/,如果需要修改访问路径,则需要在application.yml添加以下记录:
server:
#  设置访问端口号
  port: 8080
  servlet:
#    设置访问前缀
    context-path: /

补充:多环境配置文件 mavenprofile
实际开发中会有不同的开发环境,为了便于切换所以有以下操作

在这里插入图片描述
application-dev.yml
在这里插入图片描述
application-test.yml和application-pro.yml略 和dev写法一样
application.yml中的写法
在这里插入图片描述
active指明是哪个环境

2、自定义属性及读取

(1)在application.yml定义几个常量:
test_ip:
         1.181.1.1
test_port:
         9999
(2)编写Controller类读取自定义属性
public class HelloConfigController {
@Value("${test_ip}")	
private String test_ip;
@Value("${test_port}")	
private String test_port;

3、实体类属性赋值

在配置文件application.yml中添加代码

方式一:使用application.yml文件中配置信息 (两步)

在这里插入图片描述
注意:该配置文件的书写格式一定要按照规定,子属性要换行,至少两个空格,:后面至少一个空格
(1)、User类要加一个注解
@ConfigurationProperties(prefix=“userbody”)

@ConfigurationProperties(prefix="userbody")
public class User{
    private String name;
    private String password;
    private String birthday;
    private String mobile;
    private String address;
}

(2)、允许配置属性的类生效,在与启动类同包的任意类上加一个注解,建议加在Controller类上
@EnableConfigurationProperties(User.class)

@RestController
//允许配置属性的类生效
@EnableConfigurationProperties(User.class)
@RequestMapping("/demo")
public class demoController {
方式二:自定义配置文件

(1)、创建配置文件

在这里插入图片描述
文件内容:
注意:传中文时可能会出现乱码,所以可以转成unicode
在这里插入图片描述
(2.)、创建Dog类,在该类上需要加两个注解
//加载的自定义的配置文件
@Configuration
@ConfigurationProperties(prefix = “dog”)
@PropertySource(“classpath:myuser.properties”)

在这里插入图片描述
(3)、允许配置属性的类生效,在与启动类同包的任意类上加一个注解,建议加在Controller类上
@EnableConfigurationProperties(Dog.class)
当有多个类需要生效时的写法
@EnableConfigurationProperties({User.class,Dog.class})

4.访问静态资源

(1)、默认静态资源映射

Spring Boot 对静态资源映射提供了默认配置
Spring Boot 默认将 /** 所有访问映射到以下目录:
classpath:/static
classpath:/public
classpath:/resources
classpath:/META-INF/resources
在这里插入图片描述
通过浏览器可以直接访问到
http://localhost:8080/1.jpg

(2)、自定义静态资源访问
第一种方式:配置类的方式

1.在本地创建一个文件夹,比如在D盘创建一个pic的文件夹存一个图片,图片名为1.jpg

2.创建一个配置类
在这里插入图片描述
代码

package com.offcn.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class staticConfig implements WebMvcConfigurer {
    @Override
    public voi
    d addResourceHandlers(ResourceHandlerRegistry registry) {
        //自定义静态资源存储目录   file://表示本地
        registry.addResourceHandler("/pic/**").addResourceLocations("file:D:\\pic\\");
    }
}

(3)、刷新maven重启
(4)、通过地址访问图片
http://localhost:8080/pic/1.jpg

第二种方式:配置文件application.properties

(1)、在本地D盘创建一个文件夹mypath存一个图片,名为2.jpg
(2)、创建配置文件application.properties
在这里插入图片描述

#配置自定义静态资源访问目录
mypath=D:\\mypath\\
spring.resources.static-locations=classpath:/static/,classpath:/public/,classpath:/resources/,classpath:/META-INF/resources/,file:${mypath}

(3)、通过地址栏访问测试
http://localhost:8080/2.jpg

5.WebJars

概念:把静态资源打到jar包里面,相关Springboot项目通过引入jar包就可以实现静态资源引入
这里用一个Demo来讲解,更利于理解

(1)、首先创建文件夹及文件

在这里插入图片描述
在这里插入图片描述
通过地址访问测试页面可以访问到图片

(2)、新创一个maven项目,来生成静态资源包

在这里插入图片描述
在pom.xml添加代码

   <build>
        <resources>
            <resource>
                <!--打包目录-->
                <directory>${project.basedir}/src/main/resources/META-INF/resources/webjars</directory>
                <!--输出目录-->
                <targetPath>${project.build.outputDirectory}/META-INF/resources/webjars</targetPath>
            </resource>
        </resources>
    </build>

执行install操作,打包到本地仓库

(3)、删除

在这里插入图片描述

(4)、导入静态资源的依赖包

在这里插入图片描述
在这里插入图片描述

(5)、然后再启动执行去测试页面查看,发现图片还可以正常访问
<think>好的,我现在需要解决用户在Spring Boot中遇到的静态资源404无法访问的问题。首先,我得回忆一下Spring Boot处理静态资源的默认配置。根据引用[4],默认的静态资源路径是classpath下的/META-INF/resources/、/resources/、/static/和/public/这几个目录。用户如果按照约定把资源放在这些位置,应该可以自动访问,但出现404说明有问题。 可能的原因之一是路径冲突。比如用户可能自定义了资源处理器,但没有正确配置,导致覆盖了默认的设置。比如引用[3]中的例子,用户自定义了addResourceHandlers方法,但调用super.addResourceHandlers(registry)可能会导致路径被覆盖,所以需要检查是否存在这种情况。应该建议用户检查是否有自定义的WebMvcConfigurer,特别是是否调用了父类的方法或者重复注册了资源处理器。 第二个可能性是静态资源的位置不符合默认约定。用户可能把资源放在了非标准目录下,比如src/main/webapp,这时候需要确认是否启用了webapp目录的支持,如引用[2]提到的,需要添加/到资源路径中,或者在配置中明确指定该目录。 另外,缓存问题也可能导致资源无法加载。建议用户尝试清除浏览器缓存或者禁用缓存,尤其是在开发环境中,可能需要配置spring.resources.cache.period为0来禁用缓存。 还有可能用户没有正确使用模板引擎,比如Thymeleaf,导致静态资源路径引用错误。根据引用[5],如果使用Thymeleaf,应该使用th:href或th:src来正确引用资源,比如href="/css/style.css"可能需要改为th:href="@{/css/style.css}"。 另外,检查是否配置了正确的静态资源前缀。例如,如果应用部署在上下文路径下,比如http://localhost:8080/myapp/,那么静态资源的路径应该是/myapp/css/style.css,而不仅仅是/css/style.css。需要确认是否配置了server.servlet.context-path,并在前端正确引用。 还有可能是安全配置拦截了静态资源请求,比如Spring Security的配置中可能没有放行静态资源路径。需要检查Security配置,确保静态资源路径允许匿名访问。 最后,用户可能没有正确放置资源文件,比如文件位置错误或者文件名拼写错误,需要确认资源文件的实际存放路径是否与访问路径匹配。 总结下来,解决方案包括检查资源存放位置、验证自定义配置是否正确、处理缓存问题、使用正确的模板引擎标签、配置上下文路径、检查安全设置以及确认文件路径和名称的正确性。需要一步步引导用户排查这些可能性,找到具体原因并对应解决。</think>关于Spring Boot静态资源404问题的解决方案,可通过以下步骤排查: ### 一、检查默认静态资源路径 1. **确认资源存放位置** Spring Boot默认静态资源目录为: - `classpath:/META-INF/resources/` - `classpath:/resources/` - `classpath:/static/` - `classpath:/public/` 确保资源文件存放在以上目录中(如`src/main/resources/static/css/style.css`)[^4]。 2. **验证默认访问路径** 默认访问路径为`http://localhost:8080/css/style.css`,**无需**添加`/static`前缀[^2]。 --- ### 二、排查自定义配置冲突 3. **检查`WebMvcConfigurer`配置** 若自定义了`addResourceHandlers`方法,需避免覆盖默认配置: ```java @Configuration public class MvcConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/custom/**") .addResourceLocations("classpath:/custom-static/"); // 不要调用 super.addResourceHandlers(registry) [^3] } } ``` 4. **验证`spring.resources.static-locations`配置** 在`application.properties`中,若自定义该属性会**完全覆盖默认路径**,需保留默认路径: ```properties spring.resources.static-locations=classpath:/static/,classpath:/custom-static/ ``` --- ### 三、处理常见特殊场景 5. **Webapp目录资源访问** 若资源存放在`src/main/webapp`目录,需在配置中显式添加路径: ```java registry.addResourceHandler("/**") .addResourceLocations("/"); ``` 6. **模板引擎路径引用** 使用Thymeleaf时,需通过语法`th:href="@{/css/style.css}"`正确引用资源[^5]。 --- ### 四、清除缓存与调试 7. **禁用资源缓存** 在开发环境添加配置: ```properties spring.resources.cache.period=0 ``` 8. **检查浏览器控制台** 通过浏览器开发者工具查看: - 资源请求URL是否正确 - 响应状态码是否为404以外的错误(如403可能涉及安全拦截) --- ### 五、其他可能性 9. **上下文路径(Context Path)影响** 若配置了`server.servlet.context-path=/myapp`,访问路径应为`http://localhost:8080/myapp/css/style.css`。 10. **文件权限问题** 确保资源文件未被IDE或操作系统锁定,且构建时文件已复制到`target/classes`目录。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Sonk.

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值