Eclipse 安裝 Spring 插件報錯衝突：其實不需要插件，手動配置更可控

問題現象

Eclipse 安裝 Spring 插件（Spring Tool Suite / Spring IDE）報錯，疑似與已安裝的 Hibernate 插件衝突。

核心觀點：不推薦依賴 IDE 插件

• 插件版本更新滯後，易與項目依賴版本不匹配
• 插件引入額外依賴，增加環境複雜度
• **手動配置 XML/Java Config 更透明、可控、可移植**

Spring/SpringMVC 手動項目搭建步驟

1. Maven 依賴（pom.xml）

<dependencies>
    <!-- Spring Core -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.21</version>
    </dependency>
    
    <!-- Spring Web MVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.21</version>
    </dependency>
    
    <!-- Servlet API (provided) -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
    
    <!-- Jackson JSON -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.13.3</version>
    </dependency>
    
    <!-- 測試 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>5.3.21</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. web.xml 配置 DispatcherServlet

<web-app xmlns="https://xmlns.jcp.org/xml/ns/javaee"
         version="4.0">
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

3. spring-mvc.xml 核心配置

<beans xmlns="https://www.springframework.org/schema/beans"
       xmlns:mvc="https://www.springframework.org/schema/mvc"
       xmlns:context="https://www.springframework.org/schema/context"
       xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
           https://www.springframework.org/schema/beans
           https://www.springframework.org/schema/beans/spring-beans.xsd
           https://www.springframework.org/schema/mvc
           https://www.springframework.org/schema/mvc/spring-mvc.xsd
           https://www.springframework.org/schema/context
           https://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 掃描 Controller -->
    <context:component-scan base-package="com.example.controller" />
    
    <!-- 開啟註解驅動 + 靜態資源 -->
    <mvc:annotation-driven />
    <mvc:resources mapping="/resources/**" location="/resources/" />
    <mvc:resources mapping="/static/**" location="/static/" />
    
    <!-- 視圖解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

4. Controller 示例

@Controller
@RequestMapping("/user")
public class UserController {
    @GetMapping("/list")
    public String list(Model model) {
        model.addAttribute("users", userService.findAll());
        return "user/list"; // → /WEB-INF/views/user/list.jsp
    }
}

為什麼手動配置更好？

如果一定要用插件

1. 使用 **Eclipse Marketplace** 安裝 Spring Tools 4 (Spring Tool Suite 4)
2. 確保 Eclipse 版本兼容（STS4 需 Eclipse 2019-09+）
3. 安裝後 重啟 Eclipse，導入項目時選擇 Existing Maven Projects

總結

**拋棄插件依賴，擁抱 Maven + 手動配置**。這才是企業級開發的標準姿勢，也能避開 90% 的環境衝突問題。