Spring MVC controller怎么處理301跳轉

# Spring MVC Controller怎么處理301跳轉

## 1. 什么是301跳轉

301跳轉（301 Redirect）是HTTP協議中的一種永久性重定向狀態碼。當服務器返回301狀態碼時，表示請求的資源已被永久移動到新的URL，瀏覽器或爬蟲會自動跳轉到新地址，并將原地址的權重傳遞給新地址。

### 301跳轉的特點：
- **永久性**：告知搜索引擎此重定向是永久性的
- **權重傳遞**：SEO權重會從舊URL轉移到新URL
- **緩存**：瀏覽器會緩存重定向結果

## 2. Spring MVC中實現301跳轉的方式

在Spring MVC中，有多種方式可以實現301跳轉：

### 2.1 使用`RedirectView`

```java
@Controller
public class RedirectController {
    
    @GetMapping("/old-url")
    public RedirectView redirectWithRedirectView() {
        RedirectView redirectView = new RedirectView();
        redirectView.setUrl("/new-url");
        redirectView.setStatusCode(HttpStatus.MOVED_PERMANENTLY); // 設置301狀態碼
        return redirectView;
    }
}

2.2 使用ResponseEntity

@Controller
public class RedirectController {
    
    @GetMapping("/old-page")
    public ResponseEntity<Void> redirectWithResponseEntity() {
        HttpHeaders headers = new HttpHeaders();
        headers.setLocation(URI.create("/new-page"));
        return new ResponseEntity<>(headers, HttpStatus.MOVED_PERMANENTLY);
    }
}

2.3 使用redirect:前綴（僅適用于302）

注意：Spring的redirect:前綴默認使用302跳轉，不能直接用于301。如果需要301，需結合其他方式：

@Controller
public class RedirectController {
    
    @GetMapping("/old")
    public ModelAndView redirectWithModelAndView() {
        ModelAndView mav = new ModelAndView();
        mav.setViewName("redirect:/new");
        mav.setStatus(HttpStatus.MOVED_PERMANENTLY);
        return mav;
    }
}

3. 實際應用場景

3.1 網站改版URL變更

@Controller
public class WebsiteRedesignController {
    
    @GetMapping("/old/{productId}")
    public RedirectView redirectProductPage(@PathVariable String productId) {
        RedirectView redirectView = new RedirectView();
        redirectView.setUrl("/products/" + productId);
        redirectView.setStatusCode(HttpStatus.MOVED_PERMANENTLY);
        return redirectView;
    }
}

3.2 域名切換

@Controller
public class DomainChangeController {
    
    @GetMapping("/**")
    public ResponseEntity<Void> redirectToNewDomain(HttpServletRequest request) {
        String newUrl = "https://newdomain.com" + request.getRequestURI();
        HttpHeaders headers = new HttpHeaders();
        headers.setLocation(URI.create(newUrl));
        return new ResponseEntity<>(headers, HttpStatus.MOVED_PERMANENTLY);
    }
}

3.3 HTTP到HTTPS的跳轉

@Controller
public class HttpsRedirectController {
    
    @GetMapping("/secure/**")
    public ResponseEntity<Void> redirectToHttps(HttpServletRequest request) {
        String httpsUrl = "https://" + request.getServerName() + request.getRequestURI();
        HttpHeaders headers = new HttpHeaders();
        headers.setLocation(URI.create(httpsUrl));
        return new ResponseEntity<>(headers, HttpStatus.MOVED_PERMANENTLY);
    }
}

4. 測試301跳轉

使用curl命令測試：

curl -v http://localhost:8080/old-url

預期輸出應包含：

HTTP/1.1 301 
Location: /new-url

5. 注意事項

1. 緩存問題：瀏覽器會緩存301跳轉，開發時可能造成困擾，可使用無痕模式測試
2. 相對路徑：使用絕對路徑而非相對路徑，避免意外跳轉
3. 性能考慮：過多的重定向會影響網站性能
4. 鏈式跳轉：避免創建跳轉鏈（A→B→C）
5. SEO影響：確保只有需要永久轉移的URL使用301跳轉

6. 與其他重定向的比較

7. 最佳實踐

1. 集中管理重定向：創建專門的RedirectController管理所有重定向規則
2. 使用配置文件：將重定向映射關系配置在properties或數據庫中
3. 日志記錄：記錄重定向請求以便分析
4. 監控：監控404錯誤，及時添加必要的重定向

@Controller
public class CentralRedirectController {
    
    @Autowired
    private RedirectMappingService redirectService;
    
    @GetMapping("/**")
    public ResponseEntity<Void> handleRedirect(HttpServletRequest request) {
        String requestedUri = request.getRequestURI();
        String targetUrl = redirectService.getTargetUrl(requestedUri);
        
        if (targetUrl != null) {
            HttpHeaders headers = new HttpHeaders();
            headers.setLocation(URI.create(targetUrl));
            return new ResponseEntity<>(headers, HttpStatus.MOVED_PERMANENTLY);
        }
        
        throw new ResourceNotFoundException();
    }
}

8. 總結

Spring MVC提供了靈活的方式來實現301永久重定向，開發者可以根據具體場景選擇RedirectView、ResponseEntity等方式。正確的使用301跳轉不僅能提升用戶體驗，還能保持網站的SEO價值。在實際應用中，應注意跳轉的緩存特性、性能影響，并遵循最佳實踐來管理重定向規則。 “`