環(huán)境：SpringBoot3.2.5

1. 簡(jiǎn)介

這篇文章將逐一探討在SpringBoot開發(fā)中容易被忽視的7個(gè)關(guān)鍵細(xì)節(jié)，從而避免開發(fā)過程中的陷阱。

無論是你是初學(xué)者還是有經(jīng)驗(yàn)的開發(fā)者，關(guān)注這些小細(xì)節(jié)往往能夠預(yù)防許多常見問題，同時(shí)提高開發(fā)效率，減少開發(fā)過程中的重復(fù)工作，甚至可能提升所開發(fā)產(chǎn)品的質(zhì)量。

2. 核心關(guān)鍵點(diǎn)

2.1 字段避免@Autowired注入

@Autowired可以將依賴注入到組件中，但過度使用它可能會(huì)導(dǎo)致緊密的耦合和測(cè)試?yán)щy。使用構(gòu)造器注入或@Resource等方法可以使依賴關(guān)系更加清晰。

推薦做法：

優(yōu)先使用構(gòu)造器注入，因?yàn)樗梢郧逦囟x組件的依賴，并且在單元測(cè)試中更容易進(jìn)行模擬（mock）。

如果你當(dāng)前使用了Lombok，你可以利用@RequiredArgsConstructor注解來自動(dòng)生成構(gòu)造器。

private final UserRepository userRepository ;
public UserService(UserRepository userRepository) {
  this.userRepository = userRepository ;
}

我們是禁止使用Lombok的。

最后，我還是推薦使用構(gòu)造函數(shù)注入，避免字段上使用@Autowired / @Resource注解，并且Spring官方推薦的也是構(gòu)造函數(shù)注入。

2.2 避免在控制器中編寫業(yè)務(wù)邏輯

嚴(yán)格來說，Controller控制器僅負(fù)責(zé)處理HTTP請(qǐng)求和響應(yīng)。業(yè)務(wù)邏輯應(yīng)放置在其他層（如Service層）。將業(yè)務(wù)邏輯與請(qǐng)求和響應(yīng)處理混合在一起對(duì)編寫單元測(cè)試非常不利。如果將業(yè)務(wù)邏輯移動(dòng)到服務(wù)層，那么單元測(cè)試可以更加針對(duì)服務(wù)層進(jìn)行。

推薦做法：

將業(yè)務(wù)邏輯移動(dòng)到服務(wù)層（Service），并讓控制器僅處理請(qǐng)求并調(diào)用服務(wù)方法。進(jìn)行這種分離后，不僅單元測(cè)試更加方便，代碼也更容易重用。

@RestController
@RequestMapping("/products")
public class ProductController {


  private final ProductService productService ;
  public ProductController(ProductService productService) {
    this.productService = productService ;
  }


  @GetMapping("/{id}")
  public ResponseEntity<Product> getProduct(@PathVariable Long id) {
    // 調(diào)用Service進(jìn)行業(yè)務(wù)邏輯的處理
    Product product = productService.getProductById(id) ;
    return ResponseEntity.ok(product) ;
  }
}

這也是我們?nèi)粘ｉ_發(fā)中最基本的要求了。

2.3 使用@ConfigurationProperties替代@Value

使用@Value注解來獲取配置雖然簡(jiǎn)單，但缺乏結(jié)構(gòu)性。此外，過度使用會(huì)導(dǎo)致@Value注解散布在整個(gè)項(xiàng)目中，這不利于代碼的維護(hù)和重用。使用@ConfigurationProperties可以避免這些問題，使配置更清晰、更易于管理。

推薦做法：

創(chuàng)建一個(gè)專用的配置類，并使用@ConfigurationProperties注解來綁定相關(guān)的配置項(xiàng)，這增強(qiáng)了代碼的可讀性。當(dāng)在多個(gè)地方使用相同的配置類時(shí)，它有助于避免重復(fù)配置屬性，從而提高了代碼的可重用性。這種方法還使配置更具結(jié)構(gòu)性，便于維護(hù)和理解。

例如，在應(yīng)用配置的情況下，當(dāng)處理大量屬性或復(fù)雜配置結(jié)構(gòu)時(shí)，@ConfigurationProperties所提供的便利性和長(zhǎng)期影響遠(yuǎn)遠(yuǎn)超過了創(chuàng)建一個(gè)新類所需的工作量。

@ConfigurationProperties(prefix = "pack.app")
public class AppConfig {
  private String title ;
  private String version ;
  private Integer uid ;
  // getters and setters
}

2.4 避免構(gòu)造函數(shù)過于復(fù)雜

構(gòu)造器應(yīng)盡可能保持簡(jiǎn)單。做過多的初始化工作會(huì)使構(gòu)造器變得復(fù)雜且難以理解。此外，如果構(gòu)造器中做了太多工作，未來的需求變更很可能需要頻繁修改，從而增加了代碼維護(hù)的難度。它還顯著影響性能，因?yàn)樵趯?duì)象創(chuàng)建期間執(zhí)行了復(fù)雜操作。

推薦做法：

主要使用構(gòu)造器進(jìn)行依賴注入，并將初始化工作移動(dòng)到用@PostConstruct注解的方法中或在服務(wù)方法內(nèi)執(zhí)行。如果必須在構(gòu)造器中執(zhí)行大量操作，考慮實(shí)現(xiàn)延遲加載或?qū)⑵滢D(zhuǎn)換為工廠模式。

public class CommonComponent {
  private final CommonService commonService ;


  public CommonComponent(CommonService commonService) {
    this.commonService = commonService ;
  }


  @PostConstruct
  public void init() {
    // TODO
  }
}

構(gòu)造器只做基本的注入操作。其它初始化的工作通過@PostConstruct注解的方法來處理。

2.5 定義不同的環(huán)境配置文件

為不同環(huán)境（開發(fā)、測(cè)試、生產(chǎn)）使用不同的配置有助于隔離環(huán)境差異。

推薦做法：

使用application-{profile}.properties或application-{profile}.yml來為每個(gè)環(huán)境定義配置。

激活不同的配置文件：

spring:
  profiles:
    active:
    - dev

2.6 使用異常替代返回值

首先，先來看段代碼：

@Service
public class ProductService {


  private final ProductRepository productRepository ;
  public ProductService(ProductRepository productRepository) {
    this.productRepository = productRepository ;
  }


  public R<Product, String> queryById(Long id) {
    Optional<Product> opt = productRepository.findById(id) ;
    if (opt.isPresent()) {
      return R.success(opt.get()) ;
    } else {
      return R.error("商品不存在id: " + id) ;
    }
  }
}

上面代碼直接使用R作為方法的返回值顯得不夠優(yōu)雅。

如果將返回R.error的部分替換為拋出new XXException異常，這不僅能提高代碼的可讀性，還能讓服務(wù)返回業(yè)務(wù)結(jié)果，而不是與控制器結(jié)果糾纏在一起。

優(yōu)化代碼：

@Service
public class ProductService {


  private final ProductRepository productRepository ;
  public ProductService(ProductRepository productRepository) {
    this.productRepository = productRepository ;
  }


  public Product queryById(Long id) {
    return productRepository.findById(id)
      .orElseThrow(() -> new ProductNotFoundException("商品不存在id: " + id));
  }
}

Service層應(yīng)該只返回業(yè)務(wù)結(jié)果，而不應(yīng)涉及控制器的結(jié)果。此外，拋出的異?？梢宰尵S護(hù)人員立即理解，并指出問題所在。

最后，我們利用@RestControllerAdvice注解來進(jìn)行全局異常處理，以便及時(shí)捕獲業(yè)務(wù)邏輯中拋出的異常，避免500錯(cuò)誤，如下示例：

@RestControllerAdvice
public class GlobalExceptionHandler {


  @ExceptionHandler(ProductNotFoundException.class)
  public ResponseEntity<ErrorResponse> handleProductNotFoundException(ProductNotFoundException ex) {
    ErrorResponse errorResponse = new ErrorResponse(HttpStatus.NOT_FOUND.value(), ex.getMessage()) ;
    return new ResponseEntity<>(errorResponse, HttpStatus.NOT_FOUND) ;
  }
  // 其它異常處理句柄
}

有人可能會(huì)說這種拋異常處理方式是反模式設(shè)計(jì)，你覺得呢？

2.7 優(yōu)先考慮ResponseEntity作為響應(yīng)

很多人會(huì)自定義對(duì)象作為Controller接口返回的統(tǒng)一對(duì)象，但SpringBoot本身提供了一個(gè)專門的響應(yīng)實(shí)體，即ResponseEntity。

ResponseEntity提供了更大的靈活性，允許控制響應(yīng)的各個(gè)方面，包括HTTP狀態(tài)碼、響應(yīng)頭、響應(yīng)體等。這使得程序能夠更精確地構(gòu)建響應(yīng)結(jié)果，根據(jù)業(yè)務(wù)需求返回不同的HTTP狀態(tài)碼。

此外，ResponseEntity還支持泛型，允許返回不同類型的響應(yīng)體，滿足各種業(yè)務(wù)場(chǎng)景下的響應(yīng)需求。

下面是ResponseEntity API文檔說明：

圖片

這點(diǎn)并非必須遵守，當(dāng)你確實(shí)需要高度定制化，那么使用自定義的結(jié)果對(duì)象也當(dāng)然沒有問題。