jpsclient 2.7.1 → 2.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48dd1ae1aaa5dc5113053a1518852757e21f1093e6cc0f78af67a233fa99816c
-  data.tar.gz: 45d7e50bdba93716069834434e6fcc312f47ec1cb65f762c33151245507fc90d
+  metadata.gz: 3b469c45fc263d9c573736eba519b34ae855058e47b77a01428e5da3330ce052
+  data.tar.gz: cc4eb5ab5180c02022dff9df585d848cf51c1fab8914b0e129989b812501133b
 SHA512:
-  metadata.gz: 5e52ac2b47c2933708800e6a36059853638d464f5927c64037e7153c9abf39bcad5b7c19d9ee43a9075bf2e5dc88d05e3978cc760e1e402882a0eea2697a7ca6
-  data.tar.gz: ac94b28dbce9ab2622acbc1ba2a1d11e2306cf842c6afc565149f8a146d0ffa2536cece93a26471ee85afc629fa3e597f3e8e84ce7a62a19b5cbe3acb2f392e9
+  metadata.gz: 0bfbf38a960e5b308f72b28e0962eebb0425fec3a15229c77f8a01b17353012fb988db35f47363cdea5ca57151a317c09b07e9ba999019fdff2ee7c940cb8aef
+  data.tar.gz: e8952174c4e5921e3cb7dad0e98c0f72f466aac458b50342eefabf82fc4f87727610bb303dc4b6a4d454fd41cc64739455aafc2c2ace2bde5f68733bd9c5e7f9

data/lib/jpsclient/http/http_client.rb

@@ -236,6 +236,10 @@ end
 module JPSClient
   # JPS API 响应封装类 - 简化版
   class Response
+    # 登录 token 失效的业务码。调用方需要按它区分「认证失败」和「网络/服务端故障」，
+    # 提成常量避免各处硬编码
+    NEED_LOGIN_CODE = '20001'.freeze
+
     attr_reader :code
     attr_reader :data
     attr_reader :msg
@@ -269,7 +273,7 @@ module JPSClient
 
     # 20001: 登录token失效
     def need_login?
-      @need_login || @code.to_s == '20001'
+      @need_login || @code.to_s == NEED_LOGIN_CODE
     end
 
     # 20011: 没有权限访问项目

data/lib/jpsclient/upload/upload_client.rb

@@ -6,6 +6,7 @@ require 'digest'
 require 'cgi'
 require 'uri'
 require 'jpsclient/base/exception'
+require 'jpsclient/http/http_client'
 require 'jpsclient/upload/upload_config'
 require 'jpsclient/upload/upload_progress'
 require 'jpsclient/utils/logger'
@@ -98,7 +99,7 @@ module JPSClient
           end
 
           if init_result.nil? || !init_result.dig("data", "upload_id")
-              raise ExceptionError, "初始化上传失败，请检查网络或服务器状态"
+              raise ExceptionError, init_multipart_error_message(init_result)
           end
 
           upload_id = init_result["data"]["upload_id"]
@@ -169,6 +170,35 @@ module JPSClient
 
       end
 
+      # 拼装初始化上传失败的错误信息
+      #
+      # 真实原因写在接口返回的 code / msg 里（例如 20001 登录态失效），
+      # 一律报「请检查网络或服务器状态」会把认证问题误导成网络问题；
+      # 而原始响应此前只在 JPSClient.debug? 下打印，排查时通常拿不到。
+      #
+      # @param init_result [Hash, nil] init_file_multipart 的原始返回
+      # @return [String] 带上真实原因的错误信息
+      def init_multipart_error_message(init_result)
+        return "初始化上传失败：接口无响应，请检查网络或服务器状态" if init_result.nil?
+
+        code = init_result["code"]
+        msg = init_result["msg"] || init_result["message"]
+
+        # request_with_auth 遇到 20001 会自动重新登录并重试一次，
+        # 这里仍拿到 20001 说明重登也没成功，需要用户手动重新登录
+        if code.to_s == Response::NEED_LOGIN_CODE
+          detail = msg.to_s.empty? ? "code=#{code}" : "code=#{code}，msg=#{msg}"
+          return "初始化上传失败：登录态已失效，且自动重新登录未成功（#{detail}），请重新登录后重试"
+        end
+
+        parts = []
+        parts << "code=#{code}" unless code.nil?
+        parts << "msg=#{msg}" unless msg.to_s.empty?
+        parts << "响应中缺少 data.upload_id" if parts.empty?
+
+        "初始化上传失败（#{parts.join("，")}），请检查网络或服务器状态"
+      end
+
       # 安全地检查上传失败状态
       def upload_failed?
         @upload_failed_mutex.synchronize { @upload_failed }

data/lib/jpsclient/version.rb

@@ -1,3 +1,3 @@
 module JPSClient
-  VERSION = '2.7.1'
+  VERSION = '2.7.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jpsclient
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 2.7.2
 platform: ruby
 authors:
 - Your Name
@@ -296,7 +296,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.10
 specification_version: 4
 summary: JPS Platform API Client with Full API Support
 test_files: []