Tarayıcı Önbelleği — Yeni Sürümü Yayına Aldın, Müşteri Neden Hâlâ Eskisini Görüyor?

1
import { defineConfig } from 'vite';
2

3
export default defineConfig({
4
  build: {
5
    rollupOptions: {
6
      output: {
7
        // The content hash in the name: a new build with new code gets a new URL.
8
        entryFileNames: 'assets/[name].[hash].js',
9
        chunkFileNames: 'assets/[name].[hash].js',
10
        assetFileNames: 'assets/[name].[hash][extname]',
11
      },
12
    },
13
  },
14
});

1
@Configuration
2
class WebCacheConfig implements WebMvcConfigurer {
3

4
    @Override
5
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
6
        // Hashed names never change content, so a year is safe.
7
        registry.addResourceHandler("/assets/**")
8
                .addResourceLocations("classpath:/static/assets/")
9
                .setCacheControl(CacheControl.maxAge(365, TimeUnit.DAYS).cachePublic());
10
        // The HTML names the bundles: the browser must ask every time.
11
        registry.addResourceHandler("/index.html")
12
                .addResourceLocations("classpath:/static/")
13
                .setCacheControl(CacheControl.noCache());
14
    }
15

16
    @Bean
17
    FilterRegistrationBean<ShallowEtagHeaderFilter> htmlEtags() {
18
        var filter = new FilterRegistrationBean<>(new ShallowEtagHeaderFilter());
19
        filter.addUrlPatterns("/index.html");   // unchanged HTML answers 304 with no body
20
        return filter;
21
    }
22
}

1
@RestController
2
@RequestMapping("/api/accounts")
3
class BalanceController {
4

5
    private final BalanceService balances;
6

7
    BalanceController(BalanceService balances) {
8
        this.balances = balances;
9
    }
10

11
    @GetMapping("/{iban}/balance")
12
    ResponseEntity<Balance> balance(@PathVariable String iban) {
13
        return ResponseEntity.ok()
14
                .cacheControl(CacheControl.noStore())   // never on disk, never in a shared cache
15
                .body(balances.of(iban));
16
    }
17
}

1
@SpringBootTest
2
@AutoConfigureMockMvc
3
class WebCacheConfigTest {
4

5
    @Autowired MockMvc mvc;
6

7
    @Test
8
    void hashedBundlesAreCachedForAYear() throws Exception {
9
        mvc.perform(get("/assets/app.3f9a.js"))
10
                .andExpect(header().string("Cache-Control", containsString("max-age=31536000")));
11
    }
12

13
    @Test
14
    void unchangedHtmlAnswers304() throws Exception {
15
        String etag = mvc.perform(get("/index.html")).andReturn().getResponse().getHeader("ETag");
16
        mvc.perform(get("/index.html").header("If-None-Match", etag))
17
                .andExpect(status().isNotModified());
18
    }
19

20
    @Test
21
    @WithMockUser
22
    void balanceIsNeverStored() throws Exception {
23
        mvc.perform(get("/api/accounts/TR01/balance"))
24
                .andExpect(header().string("Cache-Control", "no-store"));
25
    }
26
}