<!-- spring cloud Eureka Client 啟動(dòng)器 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
<!-- zuul網(wǎng)關(guān)的重試機(jī)制，不是使用ribbon內(nèi)置的重試機(jī)制
   是借助spring-retry組件實(shí)現(xiàn)的重試
   開(kāi)啟zuul網(wǎng)關(guān)重試機(jī)制需要增加下述依賴(lài)
 -->
<dependency>
   <groupId>org.springframework.retry</groupId>
   <artifactId>spring-retry</artifactId>
</dependency>

/**
 * @EnableZuulProxy - 開(kāi)啟Zuul網(wǎng)關(guān)。
 *  當(dāng)前應(yīng)用是一個(gè)Zuul微服務(wù)網(wǎng)關(guān)。會(huì)在Eureka注冊(cè)中心中注冊(cè)當(dāng)前服務(wù)。并發(fā)現(xiàn)其他的服務(wù)。
 *  Zuul需要的必要依賴(lài)是spring-cloud-starter-zuul。
 */
@SpringBootApplication
@EnableZuulProxy
public class ZuulApplication {
    public static void main(String[] args) {
        SpringApplication.run(ZuulApplication.class, args);
    }
}

# URL pattern
# 使用路徑方式匹配路由規(guī)則。
# 參數(shù)key結(jié)構(gòu)： zuul.routes.customName.path=xxx
# 用于配置路徑匹配規(guī)則。
# 其中customName自定義。通常使用要調(diào)用的服務(wù)名稱(chēng)，方便后期管理
# 可使用的通配符有： * ** ?
# ? 單個(gè)字符
# * 任意多個(gè)字符，不包含多級(jí)路徑
# ** 任意多個(gè)字符，包含多級(jí)路徑
zuul.routes.eureka-application-service.path=/api/**
# 參數(shù)key結(jié)構(gòu)： zuul.routes.customName.url=xxx
# url用于配置符合path的請(qǐng)求路徑路由到的服務(wù)地址。
zuul.routes.eureka-application-service.url=http://127.0.0.1:8080/

# service id pattern 通過(guò)服務(wù)名稱(chēng)路由
# key結(jié)構(gòu) ： zuul.routes.customName.path=xxx
# 路徑匹配規(guī)則
zuul.routes.eureka-application-service.path=/api/**
# key結(jié)構(gòu) ： zuul.routes.customName.serviceId=xxx
# serviceId用于配置符合path的請(qǐng)求路徑路由到的服務(wù)名稱(chēng)。
zuul.routes.eureka-application-service.serviceId=eureka-application-service

# simple service id pattern 簡(jiǎn)化配置方案
# 如果只配置path，不配置serviceId。則customName相當(dāng)于服務(wù)名稱(chēng)。
# 符合path的請(qǐng)求路徑直接路由到customName對(duì)應(yīng)的服務(wù)上。
zuul.routes.eureka-application-service.path=/api/**

# ignored service id pattern
# 配置不被zuul管理的服務(wù)列表。多個(gè)服務(wù)名稱(chēng)使用逗號(hào)','分隔。
# 配置的服務(wù)將不被zuul代理。
zuul.ignored-services=eureka-application-service
# 此方式相當(dāng)于給所有新發(fā)現(xiàn)的服務(wù)默認(rèn)排除zuul網(wǎng)關(guān)訪問(wèn)方式，只有配置了路由網(wǎng)關(guān)的服務(wù)才可以通過(guò)zuul網(wǎng)關(guān)訪問(wèn)
# 通配方式配置排除列表。
zuul.ignored-services=*
# 使用服務(wù)名稱(chēng)匹配規(guī)則配置路由列表，相當(dāng)于只對(duì)已配置的服務(wù)提供網(wǎng)關(guān)代理。
zuul.routes.eureka-application-service.path=/api/**
# 通配方式配置排除網(wǎng)關(guān)代理路徑。所有符合ignored-patterns的請(qǐng)求路徑都不被zuul網(wǎng)關(guān)代理。
zuul.ignored-patterns=/**/test/**
zuul.routes.eureka-application-service.path=/api/**

# prefix URL pattern 前綴路由匹配
# 配置請(qǐng)求路徑前綴，所有基于此前綴的請(qǐng)求都由zuul網(wǎng)關(guān)提供代理。
zuul.prefix=/api
# 使用服務(wù)名稱(chēng)匹配方式配置請(qǐng)求路徑規(guī)則。
# 這里的配置將為：http://ip:port/api/appservice/**的請(qǐng)求提供zuul網(wǎng)關(guān)代理，可以將要訪問(wèn)服務(wù)進(jìn)行前綴分類(lèi)。
# 并將請(qǐng)求路由到服務(wù)eureka-application-service中。
zuul.routes.eureka-application-service.path=/appservice/**

/**
 * Zuul過(guò)濾器，必須繼承ZuulFilter父類(lèi)。
 * 當(dāng)前類(lèi)型的對(duì)象必須交由Spring容器管理。使用@Component注解描述。
 * 繼承父類(lèi)后，必須實(shí)現(xiàn)父類(lèi)中定義的4個(gè)抽象方法。
 * shouldFilter、 run、 filterType、 filterOrder
 */
@Component
public class LoggerFilter extends ZuulFilter {
    private static final Logger logger = LoggerFactory.getLogger(LoggerFilter.class);
    
    /**
     * 返回boolean類(lèi)型。代表當(dāng)前filter是否生效。
     * 默認(rèn)值為false。
     * 返回true代表開(kāi)啟filter。
     */
    @Override
    public boolean shouldFilter() {
        return true;
    }
    /**
     * run方法就是過(guò)濾器的具體邏輯。
     * return 可以返回任意的對(duì)象，當(dāng)前實(shí)現(xiàn)忽略。（spring-cloud-zuul官方解釋?zhuān)?
     * 直接返回null即可。
     */
    @Override
    public Object run() throws ZuulException {
        // 通過(guò)zuul，獲取請(qǐng)求上下文
        RequestContext rc = RequestContext.getCurrentContext();
        HttpServletRequest request = rc.getRequest();
        logger.info("LogFilter1.....method={},url={}",
                request.getMethod(),request.getRequestURL().toString());
        // 可以記錄日志、鑒權(quán)，給維護(hù)人員記錄提供定位協(xié)助、統(tǒng)計(jì)性能
        return null;
    }
    /**
     * 過(guò)濾器的類(lèi)型。可選值有：
     * pre - 前置過(guò)濾
     * route - 路由后過(guò)濾
     * error - 異常過(guò)濾
     * post - 遠(yuǎn)程服務(wù)調(diào)用后過(guò)濾
     */
    @Override
    public String filterType() {
        return "pre";
    }
    /**
     * 同種類(lèi)的過(guò)濾器的執(zhí)行順序。
     * 按照返回值的自然升序執(zhí)行。
     */
    @Override
    public int filterOrder() {
        return 0;
    }
}

/**
 * 如果需要在Zuul網(wǎng)關(guān)服務(wù)中增加容錯(cuò)處理fallback，需要實(shí)現(xiàn)接口ZuulFallbackProvider
 * spring-cloud框架，在Edgware版本(包括)之后，聲明接口ZuulFallbackProvider過(guò)期失效，
 * 提供了新的ZuulFallbackProvider的子接口 - FallbackProvider
 * 在老版本中提供的ZuulFallbackProvider中，定義了兩個(gè)方法。
 *  - String getRoute()
 *    當(dāng)前的fallback容錯(cuò)處理邏輯處理的是哪一個(gè)服務(wù)?？梢允褂猛ㄅ浞?'代表為全部的服務(wù)提供容錯(cuò)處理。
 *    如果只為某一個(gè)服務(wù)提供容錯(cuò)，返回對(duì)應(yīng)服務(wù)的spring.application.name值。
 *  - ClientHttpResponse fallbackResponse()
 *    當(dāng)服務(wù)發(fā)生錯(cuò)誤的時(shí)候，如何容錯(cuò)。
 * 新版本中提供的FallbackProvider提供了新的方法。
 *  - ClientHttpResponse fallbackResponse(Throwable cause)
 *    如果使用新版本中定義的接口來(lái)做容錯(cuò)處理，容錯(cuò)處理邏輯，只運(yùn)行子接口中定義的新方法。也就是有參方法。
 *    是為遠(yuǎn)程服務(wù)發(fā)生異常的時(shí)候，通過(guò)異常的類(lèi)型來(lái)運(yùn)行不同的容錯(cuò)邏輯。
 */
@Component
public class TestFallBbackProvider implements FallbackProvider {
    /**
     * return - 返回fallback處理哪一個(gè)服務(wù)。返回的是服務(wù)的名稱(chēng)
     * 推薦 - 為指定的服務(wù)定義特性化的fallback邏輯。
     * 推薦 - 提供一個(gè)處理所有服務(wù)的fallback邏輯。
     * 好處 - 服務(wù)某個(gè)服務(wù)發(fā)生超時(shí)，那么指定的fallback邏輯執(zhí)行。如果有新服務(wù)上線，未提供fallback邏輯，有一個(gè)通用的。
     */
    @Override
    public String getRoute() {
        return "eureka-application-service";
    }
    /**
     * fallback邏輯。在早期版本中使用。
     * Edgware版本之后，ZuulFallbackProvider接口過(guò)期，提供了新的子接口FallbackProvider
     * 子接口中提供了方法ClientHttpResponse fallbackResponse(Throwable cause)。
     * 優(yōu)先調(diào)用子接口新定義的fallback處理邏輯。
     */
    @Override
    public ClientHttpResponse fallbackResponse() {
        System.out.println("ClientHttpResponse fallbackResponse()");
        
        List<Map<String, Object>> result = new ArrayList<>();
        Map<String, Object> data = new HashMap<>();
        data.put("message", "服務(wù)正忙，請(qǐng)稍后重試");
        result.add(data);
        
        ObjectMapper mapper = new ObjectMapper();
        
        String msg = "";
        try {
            msg = mapper.writeValueAsString(result);
        } catch (JsonProcessingException e) {
            msg = "";
        }
        
        return this.executeFallback(HttpStatus.OK, msg, 
                "application", "json", "utf-8");
    }
    /**
     * fallback邏輯。優(yōu)先調(diào)用?？梢愿鶕?jù)異常類(lèi)型動(dòng)態(tài)決定處理方式。
     */
    @Override
    public ClientHttpResponse fallbackResponse(Throwable cause) {
        System.out.println("ClientHttpResponse fallbackResponse(Throwable cause)");
        if(cause instanceof NullPointerException){
            
            List<Map<String, Object>> result = new ArrayList<>();
            Map<String, Object> data = new HashMap<>();
            data.put("message", "網(wǎng)關(guān)超時(shí)，請(qǐng)稍后重試");
            result.add(data);
            
            ObjectMapper mapper = new ObjectMapper();
            
            String msg = "";
            try {
                msg = mapper.writeValueAsString(result);
            } catch (JsonProcessingException e) {
                msg = "";
            }
            
            return this.executeFallback(HttpStatus.GATEWAY_TIMEOUT, 
                    msg, "application", "json", "utf-8");
        }else{
            return this.fallbackResponse();
        }
    }
    
    /**
     * 具體處理過(guò)程。
     * @param status 容錯(cuò)處理后的返回狀態(tài)，如200正常GET請(qǐng)求結(jié)果，201正常POST請(qǐng)求結(jié)果，404資源找不到錯(cuò)誤等。
     *  使用spring提供的枚舉類(lèi)型對(duì)象實(shí)現(xiàn)。HttpStatus
     * @param contentMsg 自定義的響應(yīng)內(nèi)容。就是反饋給客戶(hù)端的數(shù)據(jù)。
     * @param mediaType 響應(yīng)類(lèi)型，是響應(yīng)的主類(lèi)型， 如： application、text、media。
     * @param subMediaType 響應(yīng)類(lèi)型，是響應(yīng)的子類(lèi)型， 如： json、stream、html、plain、jpeg、png等。
     * @param charsetName 響應(yīng)結(jié)果的字符集。這里只傳遞字符集名稱(chēng)，如： utf-8、gbk、big5等。
     * @return ClientHttpResponse 就是響應(yīng)的具體內(nèi)容。
     *  相當(dāng)于一個(gè)HttpServletResponse。
     */
    private final ClientHttpResponse executeFallback(final HttpStatus status, 
            String contentMsg, String mediaType, String subMediaType, String charsetName) {
        return new ClientHttpResponse() {
            /**
             * 設(shè)置響應(yīng)的頭信息
             */
            @Override
            public HttpHeaders getHeaders() {
                HttpHeaders header = new HttpHeaders();
                MediaType mt = new MediaType(mediaType, subMediaType, Charset.forName(charsetName));
                header.setContentType(mt);
                return header;
            }
            /**
             * 設(shè)置響應(yīng)體
             * zuul會(huì)將本方法返回的輸入流數(shù)據(jù)讀取，并通過(guò)HttpServletResponse的輸出流輸出到客戶(hù)端。
             */
            @Override
            public InputStream getBody() throws IOException {
                String content = contentMsg;
                return new ByteArrayInputStream(content.getBytes());
            }
            /**
             * ClientHttpResponse的fallback的狀態(tài)碼 返回String
             */
            @Override
            public String getStatusText() throws IOException {
                return this.getStatusCode().getReasonPhrase();
            }
            /**
             * ClientHttpResponse的fallback的狀態(tài)碼 返回HttpStatus
             */
            @Override
            public HttpStatus getStatusCode() throws IOException {
                return status;
            }
            /**
             * ClientHttpResponse的fallback的狀態(tài)碼 返回int
             */
            @Override
            public int getRawStatusCode() throws IOException {
                return this.getStatusCode().value();
            }
            /**
             * 回收資源方法
             * 用于回收當(dāng)前fallback邏輯開(kāi)啟的資源對(duì)象的。
             * 不要關(guān)閉getBody方法返回的那個(gè)輸入流對(duì)象。
             */
            @Override
            public void close() {
            }
        };
    }
}

<dependency>
    <groupId>com.marcosbarbero.cloud</groupId>
    <artifactId>spring-cloud-zuul-ratelimit</artifactId>
    <version>1.3.4.RELEASE</version>
</dependency>

# 開(kāi)啟限流保護(hù)
zuul.ratelimit.enabled=true
# 60s內(nèi)請(qǐng)求超過(guò)3次，服務(wù)端就拋出異常，60s后可以恢復(fù)正常請(qǐng)求
zuul.ratelimit.default-policy.limit=3
zuul.ratelimit.default-policy.refresh-interval=60
# 針對(duì)IP進(jìn)行限流，不影響其他IP
zuul.ratelimit.default-policy.type=origin

# 開(kāi)啟限流保護(hù)
zuul.ratelimit.enabled=true
# hystrix-application-client服務(wù)60s內(nèi)請(qǐng)求超過(guò)3次，服務(wù)拋出異常。
zuul.ratelimit.policies.hystrix-application-client.limit=3
zuul.ratelimit.policies.hystrix-application-client.refresh-interval=60
# 針對(duì)IP限流。
zuul.ratelimit.policies.hystrix-application-client.type=origin

# 開(kāi)啟zuul網(wǎng)關(guān)重試
zuul.retryable=true
# hystrix超時(shí)時(shí)間設(shè)置
# 線程池隔離，默認(rèn)超時(shí)時(shí)間1000ms
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=8000
# ribbon超時(shí)時(shí)間設(shè)置：建議設(shè)置比Hystrix小
# 請(qǐng)求連接的超時(shí)時(shí)間: 默認(rèn)5000ms
ribbon.ConnectTimeout=5000
# 請(qǐng)求處理的超時(shí)時(shí)間: 默認(rèn)5000ms
ribbon.ReadTimeout=5000
# 重試次數(shù)：MaxAutoRetries表示訪問(wèn)服務(wù)集群下原節(jié)點(diǎn)（同路徑訪問(wèn)）；MaxAutoRetriesNextServer表示訪問(wèn)服務(wù)集群下其余節(jié)點(diǎn)（換臺(tái)服務(wù)器）
ribbon.MaxAutoRetries=1
ribbon.MaxAutoRetriesNextServer=1
# 開(kāi)啟重試
ribbon.OkToRetryOnAllOperations=true

<dependency>
　　<groupId>org.springframework.retry</groupId>
　　<artifactId>spring-retry</artifactId>
</dependency>