# REV004 预存调整 prestorage-submit 开发环境调用记录（2026-04-23）

- 验证日期：2026-04-23
- 后端仓基线：`21714d64822268d8dcb7cd1296656b4c19ff95fa`
- 前端仓基线：`d2698e1f5d107422f64928086d89d4b803cd12ae`
- 目标环境：`root@192.168.10.130`
- 服务端口：`sw-gateway -> 127.0.0.1:48080`，`sw-business-server -> 127.0.0.1:48090`
- 配置依据：
  - `water-backend/sw-gateway/src/main/resources/application-dev.yaml`
  - `water-backend/sw-business/sw-business-server/src/main/resources/application-dev.yaml`
- 鉴权方式：开发环境 `sw.security.mock-enable=true`，使用 `Authorization: Bearer emsoft1` + `tenant-id: 1`

## 1. 实际调用 payload

```json
{
  "applicant": "李四",
  "applyReason": "充值错误",
  "attachmentRefs": [],
  "contactMobile": "19928382738",
  "custCode": "26041011111",
  "refundAmount": 2,
  "remark": "ssa"
}
```

## 2. 实际调用命令

### 2.1 直连 business

```bash
curl -X POST 'http://127.0.0.1:48090/admin-api/business/accounting-adjust/prestorage-submit' \
  -H 'Authorization: Bearer emsoft1' \
  -H 'tenant-id: 1' \
  -H 'Content-Type: application/json' \
  --data '{"applicant":"李四","applyReason":"充值错误","attachmentRefs":[],"contactMobile":"19928382738","custCode":"26041011111","refundAmount":2,"remark":"ssa"}'
```

### 2.2 走 gateway

```bash
curl -X POST 'http://127.0.0.1:48080/admin-api/business/accounting-adjust/prestorage-submit' \
  -H 'Authorization: Bearer emsoft1' \
  -H 'tenant-id: 1' \
  -H 'Content-Type: application/json' \
  --data '{"applicant":"李四","applyReason":"充值错误","attachmentRefs":[],"contactMobile":"19928382738","custCode":"26041011111","refundAmount":2,"remark":"ssa"}'
```

## 3. 调用结果

直连 business 与走 gateway 返回一致：

```json
{"code":500,"data":null,"msg":"系统异常"}
```

## 4. 后端日志根因

`sw-business-server` 日志显示真实异常为：

```text
java.lang.IllegalArgumentException: 账户预存余额不足
at cn.com.emsoft.sw.business.service.accountingadjust.accountProcess.AccountingAdjustProcessServiceImpl.createPrestorageAction(AccountingAdjustProcessServiceImpl.java:213)
```

对应代码位置：

- `water-backend/sw-business/sw-business-server/src/main/java/cn/com/emsoft/sw/business/service/accountingadjust/accountProcess/AccountingAdjustProcessServiceImpl.java`

关键逻辑：

- 读取客户与账户
- 将 `deposit == null` 视为 `0`
- 校验 `deposit < refundAmount` 时抛出 `IllegalArgumentException("账户预存余额不足")`

## 5. 数据库核验

开发库（`sw_system`）中当前客户与账户数据：

```sql
select id, code, name, population, address, status, tenant_id
from biz_cust
where deleted = 0 and code = '26041011111';

select id, cust_id, deposit, uncheck_money, overdraft, status, deleted, tenant_id
from biz_account
where cust_id = 67 and deleted = 0;
```

结果：

```text
biz_cust:
67 | 26041011111 | liao | 3 | 11 | 0 | 1

biz_account:
65 | 67 | null | null | 0.0000 | 0 | 0 | 1
```

结论：当前测试客户 `26041011111` 的 `biz_account.deposit` 为空，业务侧按 `0` 处理，因此退款金额 `2` 会命中“账户预存余额不足”。

## 6. 结论

本次 `prestorage-submit` 调用链路本身可达，鉴权可用，接口也已命中后端业务逻辑。
失败原因不是网关/路由/权限，而是当前测试数据不满足退款校验条件：

- 客户存在
- 账户存在
- 账户预存余额为空（按 0 处理）
- `refundAmount = 2`，因此提交失败

## 7. 后续建议

二选一：

1. 修正该测试客户的 `biz_account.deposit`，使其大于等于 `2`
2. 改用当前开发库中预存余额充足的客户进行 `prestorage-submit` 联调

附带观察：当前前端收到的是泛化后的 `系统异常`，而非后端真实业务提示 `账户预存余额不足`。如果需要提升联调效率，可后续评估是否将该类参数/业务校验异常以明确业务消息返回前端。