jpsclient 2.7.0 → 2.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c96b5ac6d4cc1926b3ed272182eb162381f858180369c2c1c0a119937ce1dc4
-  data.tar.gz: 1ff46ef1dbc14c78ebc34eafa722402299d51f5685f4b949256c533690c4883e
+  metadata.gz: 3b469c45fc263d9c573736eba519b34ae855058e47b77a01428e5da3330ce052
+  data.tar.gz: cc4eb5ab5180c02022dff9df585d848cf51c1fab8914b0e129989b812501133b
 SHA512:
-  metadata.gz: b042d80d7475b6d3477ba406a52343899e8557270db0de0845304a4d9c8a88326be30fa2eb61d345401b0746cda2413e19e088806facfceeca7535437f120401
-  data.tar.gz: e0ad15a3b46d560381c4b51330dc599eabb2a46b00fa1de50428f0c30458fdedc09bcd2d3d403bf9a26eff14a31e9c56d0480f8b510acadb0f504931ef073d72
+  metadata.gz: 0bfbf38a960e5b308f72b28e0962eebb0425fec3a15229c77f8a01b17353012fb988db35f47363cdea5ca57151a317c09b07e9ba999019fdff2ee7c940cb8aef
+  data.tar.gz: e8952174c4e5921e3cb7dad0e98c0f72f466aac458b50342eefabf82fc4f87727610bb303dc4b6a4d454fd41cc64739455aafc2c2ace2bde5f68733bd9c5e7f9

data/lib/jpsclient/api/commit_log.rb

@@ -33,8 +33,8 @@ module JPSClient
       # @param workflowId [Integer] 工作流ID（必需）
       # @param params [Hash] 其他参数
       # @option params [Boolean] :single 是否单个提交（默认 true）
-      # @option params [String] :branch 分支名称（单数形式）
-      # @option params [Array<String>] :branches 分支名称数组（向后兼容）
+      # @option params [Array<String>, String] :branches 分支名称数组，服务端 CommitLogSendMessageDto 的字段
+      # @option params [String] :branch 分支名称（单数形式，调用方便利写法，内部归一化为 branches）
       # @option params [Array<String>] :commitIds 提交ID数组
       # @option params [Integer] :startTimestamp 开始时间戳
       # @option params [Integer] :endTimestamp 结束时间戳
@@ -52,8 +52,11 @@ module JPSClient
         }
 
         # 添加可选参数
-        body_params[:branch] = params[:branch] if params[:branch]               # 支持单数形式
-        body_params[:branches] = params[:branches] if params[:branches]         # 向后兼容复数形式
+        # 服务端 CommitLogSendMessageDto 只有 branches 数组字段，branch 单数会被直接丢弃，
+        # 因此单数写法在这里归一化为数组，不再原样透传
+        branches = params[:branches] || params[:branch]
+        body_params[:branches] = Array(branches).compact if branches
+
         body_params[:commitIds] = params[:commitIds] if params[:commitIds]
         body_params[:startTimestamp] = params[:startTimestamp] if params[:startTimestamp]
         body_params[:endTimestamp] = params[:endTimestamp] if params[:endTimestamp]

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.0'
+  VERSION = '2.7.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jpsclient
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  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: []