IntelliJ IDEA 啟動報錯 "Cannot open URL" 根因：過濾器攔截配置錯誤導致所有請求被阻斷

IntelliJ IDEA 啟動報錯 "Cannot open URL" 根因：過濾器攔截配置錯誤導致所有請求被阻斷

現象

IntelliJ IDEA 啟動時彈出錯誤對話框：Cannot open URL: https://localhost:8080/xxx，或項目運行後無法訪問任意端點，控制台無異常堆棧。

根因排查

檢查 web.xml 或 Spring Security 配置，發現過濾器映射配置為 /* 且無排除規則，導致靜態資源、錯誤頁、Actuator 端點等所有請求均被攔截，甚至包含 IDEA 內部檢測請求。

錯誤配置示例

<!-- web.xml 錯誤示例 -->
<filter>
    <filter-name>authFilter</filter-name>
    <filter-class>com.example.AuthFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>authFilter</filter-name>
    <url-pattern>/*</url-pattern>  <!-- 攔截所有路徑，含靜態資源、error頁、health端點 -->
</filter-mapping>

正確配置策略

1. 精確匹配業務路徑：僅攔截需認證的 API 路徑（如 /api/*、/secure/*）。
2. 排除靜態資源與公共端點：

<filter-mapping>
    <filter-name>authFilter</filter-name>
    <url-pattern>/api/*</url-pattern>
</filter-mapping>
<filter-mapping>
    <filter-name>authFilter</filter-name>
    <url-pattern>/secure/*</url-pattern>
</filter-mapping>

<!-- 或使用 Servlet 3.0+ @WebFilter 配合排除 -->
@WebFilter(urlPatterns = "/api/*", dispatcherTypes = {DispatcherType.REQUEST, DispatcherType.FORWARD})

Spring Security 最佳實踐

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/static/**", "/css/**", "/js/**", "/images/**", "/favicon.ico").permitAll()
                .antMatchers("/actuator/health", "/actuator/info", "/error").permitAll()
                .anyRequest().authenticated()
            .and()
                .formLogin().loginPage("/login").permitAll()
            .and()
                .logout().permitAll();
    }
}

排查清單

總結

Cannot open URL 多數由過濾器/安全配置過度攔截引起。遵循「最小權限原則」配置攔截路徑，顯式放行靜態資源、錯誤頁、健康檢查端點，可避免 90% 此類問題。調試時可暫時註釋過濾器驗證是否為配置問題。