Spring Boot не обслуживает статический контент

Я не могу заставить мой проект Spring-boot обслуживать статический контент.

Я поместил папку с именем staticпод src/main/resources. Внутри него есть папка с именем images. Когда я упаковываю приложение и запускаю его, оно не может найти изображения, которые я поместил в эту папку.

Я пытался поставить статические файлы public, resourcesи , META-INF/resourcesно ничего не работает.

Если я jar -tvf app.jar, я вижу, что файлы находятся внутри jar в правой папке: /static/images/head.pngнапример, но с вызовом: http://localhost:8080/images/head.pngвсе, что я получаю, это404

Есть идеи, почему Spring-Boot не находит это? (Я использую 1.1.4 BTW)

Не воскрешать мертвых более чем через год, но во всех предыдущих ответах упущены некоторые важные моменты:

1. @EnableWebMvcна вашем уроке отключат org.springframework.boot.autoconfigure.web.WebMvcAutoConfiguration. Это хорошо, если вы хотите полный контроль, но в противном случае это проблема.

2. Нет необходимости писать какой-либо код, чтобы добавить другое место для статических ресурсов в дополнение к тому, что уже предоставлено. Глядя на org.springframework.boot.autoconfigure.web.ResourcePropertiesv1.3.0.RELEASE, я вижу поле, staticLocationsкоторое можно настроить в application.properties. Вот фрагмент из источника:

   /**
    * Locations of static resources. Defaults to classpath:[/META-INF/resources/,
    * /resources/, /static/, /public/] plus context:/ (the root of the servlet context).
    */
   private String[] staticLocations = RESOURCE_LOCATIONS;

3. Как упоминалось ранее, URL запроса будет разрешен относительно этих мест. Таким образом src/main/resources/static/index.htmlбудет обслуживаться, когда запрос URL /index.html. Класс, который отвечает за разрешение пути, начиная с Spring 4.1, является org.springframework.web.servlet.resource.PathResourceResolver.

4. Сопоставление с суффиксным шаблоном включено по умолчанию, что означает, что для URL-адреса запроса /index.htmlSpring будет искать соответствующие обработчики /index.html. Это проблема, если целью является предоставление статического контента. Чтобы отключить это, расширьте WebMvcConfigurerAdapter(но не используйте @EnableWebMvc) и переопределите, configurePathMatchкак показано ниже:

   @Override
   public void configurePathMatch(PathMatchConfigurer configurer) {
       super.configurePathMatch(configurer);
   
       configurer.setUseSuffixPatternMatch(false);
   }

ИМХО, единственный способ уменьшить количество ошибок в вашем коде - это не писать код, когда это возможно. Используйте то, что уже предоставлено, даже если это потребует некоторых исследований, отдача того стоит.

В отличие от того, что говорится в Spring-Boot, чтобы заставить мой Spring-Boar-файл обслуживать контент: мне пришлось добавить специально зарегистрировать мой контент src / main / resources / static через этот класс конфигурации:

@Configuration
public class StaticResourceConfiguration implements WebMvcConfigurer {

    private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
            "classpath:/META-INF/resources/", "classpath:/resources/",
            "classpath:/static/", "classpath:/public/" };

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
            .addResourceLocations(CLASSPATH_RESOURCE_LOCATIONS);
    }
}

У меня была похожая проблема, и оказалось, что простым решением было расширить класс конфигурации WebMvcAutoConfiguration:

@Configuration
@EnableWebMvc
@ComponentScan
public class ServerConfiguration extends WebMvcAutoConfiguration{
}

Мне не нужен был какой-либо другой код, который позволял бы обслуживать мой статический контент, однако я поместил каталог publicпод именем src/main/webappи настроил maven так, чтобы он указывал на src/main/webappкаталог ресурсов. Это означает, что publicон скопирован target/classesи, следовательно, находится в пути к классам во время выполнения для поиска spring-boot / tomcat.

Найдите контроллеры, сопоставленные с «/» или без пути.

У меня была такая проблема, я получил 405 ошибок и много дней бился головой. Проблемой оказался @RestControllerаннотированный контроллер, который я забыл аннотировать @RequestMappingаннотацией. Я предполагаю, что этот сопоставленный путь по умолчанию равен "/" и заблокировал статическое сопоставление ресурсов контента.

Конфигурация может быть выполнена следующим образом:

@Configuration
@EnableWebMvc
public class WebMvcConfig extends WebMvcAutoConfigurationAdapter {

// specific project configuration

}

Здесь важно то, что вы WebMvcConfig можете переопределить addResourceHandlersметод и, следовательно, вам нужно явно вызывать super.addResourceHandlers(registry)(это правда, что если вы удовлетворены расположением ресурсов по умолчанию, вам не нужно переопределять какой-либо метод).

Еще одна вещь , которая должна быть прокомментированы здесь в том , что эти места ресурсов по умолчанию ( /static, /public, /resourcesи /META-INF/resources) будут регистрироваться только при наличии уже не обработчик ресурсов сопоставляется с /**.

С этого момента, если у вас есть изображение, например, по src/main/resources/static/imagesимени image.jpg, вы можете получить к нему доступ, используя следующий URL: http://localhost:8080/images/image.jpg(сервер запущен на порту 8080 и приложение развернуто в корневом контексте).

Вы проверяли справочные документы Spring Boot ?

По умолчанию Spring Boot будет предоставлять статический контент из папки с именем /static(или /publicили /resourcesили /META-INF/resources) в пути к классам или из корня ServletContext.

Вы также можете сравнить свой проект с руководством по обслуживанию веб-контента в Spring MVC или проверить исходный код проекта spring-boot-sample-web-ui .

У меня возникла именно эта проблема, затем я понял, что определил в своем application.properties:

spring.resources.static-locations=file:/var/www/static

Который отменял все остальное, что я пробовал. В моем случае я хотел оставить оба, поэтому я просто сохранил свойство и добавил:

spring.resources.static-locations=file:/var/www/static,classpath:static

Который обслуживал файлы из src / main / resources / static как localhost: {port} /file.html.

Ничто из вышеперечисленного не сработало для меня, потому что никто не упомянул об этом небольшом свойстве, которое можно было легко скопировать из Интернета для другой цели;)

Надеюсь, поможет! Я подумал, что это будет хорошо в этом длинном посте ответов для людей с этой проблемой.

Я думаю, что предыдущие ответы очень хорошо относятся к теме. Тем не менее, я бы добавил, что в одном случае, когда в вашем приложении включена Spring Security, вам, возможно, придется специально указать Spring, чтобы он разрешал запросы к другим каталогам статических ресурсов, например, "/ static / fonts" .

В моем случае у меня были "/ static / css", "/ static / js", "/ static / images" по умолчанию, но / static / fonts / ** была заблокирована моей реализацией Spring Security.

Ниже приведен пример того, как я это исправил.

@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {
.....
    @Override
    protected void configure(final HttpSecurity http) throws Exception {
        http.authorizeRequests().antMatchers("/", "/fonts/**").permitAll().
        //other security configuration rules
    }
.....
}

Просто чтобы добавить еще один ответ на старый вопрос ... Люди упоминали, что @EnableWebMvcбудет предотвращать WebMvcAutoConfigurationзагрузку, то есть код, отвечающий за создание обработчиков статических ресурсов. Есть и другие условия, которые также будут препятствовать WebMvcAutoConfigurationзагрузке. Самый простой способ увидеть это - посмотреть на источник:

https://github.com/spring-projects/spring-boot/blob/master/spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/servlet/ WebMvcAutoConfiguration.java # L139-L141

В моем случае я включал библиотеку, у которой был класс, который расширяется, WebMvcConfigurationSupportи это условие, которое предотвратит автоконфигурацию:

@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)

Важно никогда не расширяться WebMvcConfigurationSupport. Вместо этого простирайтесь от WebMvcConfigurerAdapter.

ОБНОВЛЕНИЕ: правильный способ сделать это в 5.x - реализовать WebMvcConfigurer

Это решение работает для меня:

Сначала поместите папку ресурсов в webapp / WEB-INF, как указано в структуре

-- src
  -- main
    -- webapp
      -- WEB-INF
        -- resources
          -- css
          -- image
          -- js
          -- ...

Во-вторых, весной конфигурационный файл

@Configuration
@EnableWebMvc
public class MvcConfig extends WebMvcConfigurerAdapter{

    @Bean
    public ViewResolver getViewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".html");
        return resolver;
    }

    @Override
    public void configureDefaultServletHandling(
            DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/resource/**").addResourceLocations("WEB-INF/resources/");
    }
}

Затем вы можете получить доступ к содержимому вашего ресурса, например, http: // localhost: 8080 / resource / image / yourimage.jpg

Есть две вещи, которые следует учитывать (Spring Boot v1.5.2.RELEASE): 1) Проверить все классы контроллера для аннотации @EnableWebMvc, удалить ее, если есть 2) Проверить классы контроллера, для которых используется аннотация - @RestController или @Controller , Не смешивайте Rest API и поведение MVC в одном классе. Для MVC используйте @Controller, а для REST API используйте @RestController

Выполнение 2-х вещей решило мою проблему. Теперь моя весенняя загрузка загружает статические ресурсы без каких-либо проблем. @Controller => load index.html => загружает статические файлы.

@Controller
public class WelcomeController {

    // inject via application.properties
    @Value("${welcome.message:Hello}")
    private String message = "Hello World";

    @RequestMapping("/")
    public String home(Map<String, Object> model) {
        model.put("message", this.message);
        return "index";
    }

}

index.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<title>index</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />


    <link rel="stylesheet/less" th:href="@{/webapp/assets/theme.siberia.less}"/>

    <!-- The app's logic -->
    <script type="text/javascript" data-main="/webapp/app" th:src="@{/webapp/libs/require.js}"></script>
    <script type="text/javascript">
        require.config({
            paths: { text:"/webapp/libs/text" }
        });
    </script>



   <!-- Development only -->
     <script type="text/javascript" th:src="@{/webapp/libs/less.min.js}"></script>


</head>
<body>

</body>
</html>

Поместите статические ресурсы в каталог:

/src/main/resources/static

добавить это свойство в файл application.properties

server.servlet.context-path=/pdx

Вы можете получить доступ с http: // localhost: 8080 / pdx / images / image.jpg

Если проблема возникает при запуске приложения из среды IDE (т.е. начиная с Eclipse или IntelliJ Idea) и с использованием Maven, ключом к решению является документация Spring-boot Getting Started :

Если вы используете Maven, выполните:

mvn package && java -jar target/gs-spring-boot-0.1.0.jar

Важной частью является добавление packageцели, которая будет запущена до фактического запуска приложения. (Идея: Runменю Edit Configrations..., Addи там выберите Run Maven Goalи укажите packageцель в поле)

Я использую 1.3.5 и размещаю кучу REST-сервисов через реализацию на Джерси. Это работало нормально, пока я не решил добавить пару файлов HTMLs + js. Ни один из ответов на этом форуме не помог мне. Однако, когда я добавил следующую зависимость в свой pom.xml, все содержимое в src / main / resources / static наконец показывалось через браузер:

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<dependency>

Кажется, что spring-web / spring-webmvc является важной транзитивной зависимостью, которая позволяет включить автоматическую настройку весенней загрузки.

К вашему сведению: я также заметил, что могу испортить отлично работающее приложение с весенней загрузкой и запретить ему показывать содержимое из статической папки, если я добавлю контроллер плохого отдыха, например, так

 @RestController
public class BadController {
    @RequestMapping(method= RequestMethod.POST)
    public String someMethod(@RequestParam(value="date", required=false)String dateString, Model model){
        return "foo";
    }
}

В этом примере после добавления плохого контроллера в проект, когда браузер запрашивает файл, доступный в статической папке, ответом на ошибку является « 405 Method Not Allowed ».

Пути уведомления не отображаются в примере плохого контроллера.

Я столкнулся с той же проблемой в весенней загрузке 2.1.3, говоря, что ресурс не найден 404. Я удалил ниже из applicationatiion.properties .

#spring.resources.add-mappings=true
#spring.resources.static-locations=classpath:static
#spring.mvc.static-path-pattern=/**,

Удалил @enableWebMVC и удалил все переопределения WebMvcConfigurer

// @ EnableWebMvc

Также убедитесь, что у вас есть @EnableAutoConfiguration в вашей конфигурации.

И поместите все статические ресурсы в src / main / resources / static, и это, наконец, сработало как волшебство ..

используя весеннюю загрузку 2. *, у меня есть контроллер, который отображается на маршруты GetMapping({"/{var}", "/{var1}/{var2}", "/{var1}/{var2}/{var3}"})и бум, мое приложение перестает обслуживать ресурсы.

я знаю, что не рекомендуется иметь такие маршруты, но все зависит от приложения, которое вы создаете (в моем случае, у меня нет выбора, кроме как иметь такие маршруты)

так вот мой взлом, чтобы убедиться, что мое приложение снова обслуживает ресурсы. У меня просто есть контроллер, который отображается на мои ресурсы. так как весна сначала будет соответствовать прямому маршруту перед тем, у которого есть переменная, я решил добавить метод контроллера, который сопоставляется /imgaes/{name}и повторяется для других ресурсов

@GetMapping(value = "/images/{image}", produces = {MediaType.IMAGE_GIF_VALUE, MediaType.IMAGE_JPEG_VALUE, MediaType.IMAGE_PNG_VALUE})
    public @ResponseBody
    byte[] getImage(@PathVariable String image) {
        ClassPathResource file = new ClassPathResource("static/images/" + image);
        byte[] bytes;
        try {
            bytes = StreamUtils.copyToByteArray(file.getInputStream());
        } catch (IOException e) {
            throw new ResourceNotFoundException("file not found: " + image);
        }
        return bytes;
    }

и это решило мою проблему

Возникла такая же проблема, используя gradle и eclipse, и часами пытался ее выяснить.

Кодирование не требуется, уловка в том, что вы должны использовать пункт меню New-> Source Folder (NOT New -> Folder), чтобы создать статическую папку в src / main / resources. Не знаю, почему это работает, но сделал новую -> исходную папку, затем я назвал папку статической (тогда в диалоговом окне с исходной папкой выдается сообщение об ошибке, для которого необходимо проверить: обновить фильтры исключений в других исходных папках, чтобы разрешить вложение). В мою новую статическую папку я добавил index.html и теперь она работает.

Ну, иногда стоит проверить, переопределяли ли вы глобальные отображения каким-либо контроллером остальных. Простой пример ошибки (котлин):

@RestController("/foo")
class TrainingController {

    @PostMapping
    fun bazz(@RequestBody newBody: CommandDto): CommandDto = return commandDto

}

В приведенном выше случае вы получите при запросе статических ресурсов:

{
    title: "Method Not Allowed",
    status: 405,
    detail: "Request method 'GET' not supported",
    path: "/index.html"
}

Причина этого может быть то , что вы хотели карту , @PostMappingчтобы /fooно забыть о @RequestMappingаннотации на @RestControllerуровне. В этом случае все запросы сопоставлены, POSTи вы не получите статический контент в этом случае.

Если вы добавите этот код в ресурсы src / main / resources / static, то весь статический контент из src / main / resources / static будет доступен в "/":

@Configuration
public class StaticResourcesConfigurer implements WebMvcConfigurer {
    public void addResourceHandlers(final ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/resources/**").addResourceLocations("classpath:/resources/static/");
    }
}

В моем случае некоторые статические файлы не обслуживались, например шрифты .woff и некоторые изображения. Но css и js работали просто отлично.

Обновление. Гораздо лучшим решением для правильной работы Spring Boot со шрифтами woff является настройка фильтрации ресурсов, упомянутой в этом ответе, например (обратите внимание, что вам нужно включить и исключить):

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
            <exclude>static/aui/fonts/**</exclude>
        </excludes>
    </resource>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>false</filtering>
        <includes>
            <include>static/aui/fonts/**</include>
        </includes>
    </resource>
</resources>

----- Старое решение (работает, но испортило некоторые шрифты) -----

Другое решение состояло в том, чтобы отключить сопоставление паттерна суффикса с setUseSuffixPatternMatch(false)

@Configuration
public class StaticResourceConfig implements WebMvcConfigurer {
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        // disable suffix matching to serve .woff, images, etc.
        configurer.setUseSuffixPatternMatch(false);
    }
}

Кредиты: @Abhiji указал мне 4. в правильном направлении!

Запросы к / ** оцениваются для статических расположений, настроенных в resourceProperties .

добавление следующего в application.properties, возможно, единственное, что вам нужно сделать ...

spring.resources.static-locations=classpath:/myresources/

это перезапишет статические местоположения по умолчанию, которые:

ResourceProperties.CLASSPATH_RESOURCE_LOCATIONS = { "classpath:/META-INF/resources/",
        "classpath:/resources/", "classpath:/static/", "classpath:/public/" };

Возможно, вы не захотите этого делать и просто убедитесь, что ваши ресурсы окажутся в одной из этих папок по умолчанию.

Выполнение запроса: если бы файл example.html хранился в /public/example.html, я мог бы получить к нему следующий доступ:

<host>/<context-path?if you have one>/example.html

Если бы я хотел еще один URI, как <host>/<context-path>/magico/*для файлов в classpath: / magicofiles / *, вам нужно немного больше конфигурации

@Configuration
class MyConfigClass implements WebMvcConfigurer

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/magico/**").addResourceLocations("/magicofiles/");
}

Как сказано выше, файл должен быть в $ClassPath/static/images/name.png(/ static или / public или / resources или / META-INF / resources). Этот $ ClassPath означает main/resourcesилиmain/java dir.

Если ваши файлы не в стандартных папках, вы можете добавить следующую конфигурацию:

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

@Override
public void configure(WebSecurity web) throws Exception {
    web.ignoring().antMatchers("/lib/**"); // like this
}

@Autowired
public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception {
        // ... etc.
}
...

}