对okhttp参数的一些思考

背景

项目中使用OkHttp访问三方服务

参数

创建okhttp客户端类的时候需要设置一些参数，有些可能是坑，仅供参考：

client = new OkHttpClient.Builder() .dispatcher(new Dispatcher(executorService)) .connectionPool(new ConnectionPool(maxIdleConnections, keepAliveDurationMills, TimeUnit.MILLISECONDS)) .readTimeout(readTimeoutMills, TimeUnit.MILLISECONDS) .connectTimeout(connectTimeoutMills, TimeUnit.MILLISECONDS) .writeTimeout(writeTimeoutMills, TimeUnit.MILLISECONDS) .protocols(Util.immutableList(Protocol.HTTP_1_1)) .connectionSpecs(Arrays.asList(TLS_SPEC, ConnectionSpec.CLEARTEXT)) .build(); client.dispatcher().setMaxRequests(maxRequests); client.dispatcher().setMaxRequestsPerHost(maxRequestsPerHost);
参数	意义	推荐值及原则
executorService	内部执行http请求的实际线程池	默认executorService = new ThreadPoolExecutor(0, Integer.MAX_VALUE, 60, TimeUnit.SECONDS, new SynchronousQueue<Runnable>(), Util.threadFactory("OkHttp Dispatcher", false)); 没有常驻线程，性能低，线程没有限制上限。
maxIdleConnections	连接池大小，指单个okhttpclient实例所有连接的连接池。	默认：5，值的设置与业务请求量有关，如果请求三方的tps是200，建议这个值设置在200左右。
keepAliveDurationMills	连接池中连接的最大时长	默认5分钟，依据业务场景来确定有效时间，如果不确定，那就保持5分钟
connectTimeoutMills	连接的最大超时时间	默认10秒
readTimeoutMills	读超时	默认10秒，如果是流式读，那建议设置长一点时间。 With this option set to a non-zero timeout, a read() call on the InputStream associated with this Socket will block for only this amount of time. If the timeout expires, a java.net.SocketTimeoutException is raised, though the Socket is still valid.
writeTimeoutMills	写超时	默认10秒，如果是流式写，那建议设置长一点时间
maxRequests	当前okhttpclient实例最大的并发请求数	默认：64，默认的64一般满足不了业务需要。这个值一般要大于maxRequestPerHost，如果这个值小于maxRequestPerHost会导致，请求单个主机的并发不可能超过maxRequest.
maxRequestPerHost	单个主机最大请求并发数，这里的主机指被请求方主机，一般可以理解对调用方有限流作用。注意：websocket请求不受这个限制。	默认：4，一般建议与maxRequest保持一致。 这个值设置，有如下几个场景考虑： （1）如果被调用方的并发能力只能支持200，那这个值最好不要超过200，否则对调用方有压力； （2）如果当前okhttpclient实例只对一个调用方发起调用，那这个值与maxRequests保持一致； （3）如果当前okhttpclient实例在一个事务中对n个调用方发起调用，n * maxReuestPerHost要接近maxRequest

maxRequests和maxReuestsPerHost值的设置与executorService线程池的设置有关联，请注意。maxRequests和maxRequestPerHost是okhttp内部维持的请求队列，而executorservice是实际发送请求的线程。如果maxRequests和maxReuestPerHost设置太大，executorService会因为线程太少而阻塞发送。