fix(claim): 透出 affiliate_dash 上游错误，便于排查提交 UID 失败

上游 4xx 不再一律打成 502 兜底文案；affiliate_dash 依赖错误优先展示真实 message。

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/backend/src/utils/http.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict'
 import test from 'node:test'
 
-import { resolveRouteErrorLogLevel } from './http.js'
+import { buildErrorPayload, createHttpError, resolveRouteErrorLogLevel } from './http.js'
 
 test('expected worker session expiry is debug-level', () => {
   assert.equal(
@@ -14,3 +14,22 @@ test('expected worker session expiry is debug-level', () => {
   )
   assert.equal(resolveRouteErrorLogLevel({ statusCode: 500, errorCode: 'internal_error' }), 'error')
 })
+
+test('affiliate_dash errors surface upstream message even when mapped to 502', () => {
+  const error = createHttpError('乐玩开放平台 AccessKey 或 SecretKey 未配置', {
+    statusCode: 502,
+    errorCode: 'affiliate_dash_http_failed',
+  })
+  const payload = buildErrorPayload(error, '提交 UID 失败')
+  assert.equal(payload.msg, '乐玩开放平台 AccessKey 或 SecretKey 未配置')
+  assert.equal(payload.errorCode, 'affiliate_dash_http_failed')
+})
+
+test('generic 5xx still uses fallback message', () => {
+  const error = createHttpError('secret internal boom', {
+    statusCode: 500,
+    errorCode: 'internal_error',
+  })
+  const payload = buildErrorPayload(error, '服务内部错误')
+  assert.equal(payload.msg, '服务内部错误')
+})

apps/backend/src/utils/http.ts

@@ -29,12 +29,16 @@ export function buildSuccessPayload(data: unknown, msg: string = 'ok') {
 
 export function buildErrorPayload(error: unknown, fallbackMessage: string) {
   const classification = classifyRouteError(error)
-  const message =
-    classification.statusCode >= 500
+  const errorMessage = error instanceof Error ? String(error.message || '').trim() : ''
+  // 依赖方错误（如 affiliate_dash）即使映射为 5xx，也优先透出上游可读原因。
+  const preferUpstreamMessage =
+    errorMessage &&
+    (classification.statusCode < 500 || classification.errorCode.startsWith('affiliate_dash'))
+  const message = preferUpstreamMessage
+    ? errorMessage
+    : classification.statusCode >= 500
       ? fallbackMessage || '服务内部错误'
-      : error instanceof Error
-        ? error.message
-        : fallbackMessage
+      : errorMessage || fallbackMessage
 
   return {
     code: 1,