1895830907
Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: multica-agent <github@multica.ai>
100 lines
5.7 KiB
Markdown
100 lines
5.7 KiB
Markdown
# B-225 双端验收包无法联网
|
||
|
||
分支：`agent/agent/a4ad7eed`（基于问题基线 `18d890ae7fdf66fa4df67360469f0f143641666a`）
|
||
施工依据：B-148 第13阶段返工；对照旧包 `v1.0.6-internal-test`、故障预发布 `v3.8.3-internal-acceptance`、本卡新源码与新产物。
|
||
本卡只修客户端/构建配置并重打候选包，不改现网服务、不覆盖 Gitea 预发布 tag、不把构建成功当成真机联网通过。
|
||
|
||
**结论：Windows 根因是 Vite 未注入 `VITE_*`，登录打到 `undefined`；Android 根因是默认 host 为官方占位域名，且回退端口 10008/10009 已关闭。候选包产物级已写入公司内网地址。真机登录未测。**
|
||
|
||
## 根因（产物对照，不是猜）
|
||
|
||
公司内网现况（构建机只读探测 `192.168.200.11`）：10001 / 10002 / 10010 / 17880 开；官方 chat 默认口 10008 / 10009 关。账号服务 `POST /api/login` 有业务响应。
|
||
|
||
| 对照项 | 旧可用包 `v1.0.6-internal-test` | 故障预发布 `v3.8.3-internal-acceptance` | 本卡源码 + 候选包 |
|
||
|---|---|---|---|
|
||
| Windows 登录 | asar 字面量 `http://192.168.200.11:10010/api/login` | asar 为 `` `${{}.VITE_ACCOUNT_URL}/api/login` ``（Vite 空对象） | asar 字面量 `http://192.168.200.11:10010` 等四条地址 |
|
||
| Windows IM / LiveKit | `:10002` / `:10001` / `:17880` 字面量 | 同样未注入 | 同上，四条均字面量 |
|
||
| Android `libapp.so` | 仅公司地址 | 公司地址 + `your-server-ip or your-domain` + `:10008` | 公司四条地址；`your-server-ip` / `:10008` / `:10009` 为 0 |
|
||
|
||
Windows 直接原因：仓库根 `.gitignore` 忽略 `.env`，B-213 打包时没有 `.env` / `.env.production`，`vite build` 把 `import.meta.env.VITE_*` 编成空对象属性。
|
||
|
||
Android 直接原因：`Config._host` 不是 IP，启动默认走 HTTPS 假域名；`HttpUtil.init()` 在 `CompanyBootstrap` 之前拍死 `dio.baseUrl`；`ApiService.setBaseUrl` 曾只写 host 不带 `http://` 和端口；`Urls` 的 `static final` 第一次读取会冻结错误 URL；官方 chat 口已关，公司账号口是 10010。
|
||
|
||
## 最小修复
|
||
|
||
| 端 | 改动 | 作用 |
|
||
|---|---|---|
|
||
| PC | 新增 `pc-client/.env.production`（可入库） | `vite build` 默认 production 能注入内网地址 |
|
||
| PC | 新增 `pc-client/src/config/endpoints.ts`，登录/目录/RTC/IM 改走兜底常量 | 即使漏加载 env，也不会变成 `undefined` |
|
||
| Android | `Config._host = 192.168.200.11`；auth/chatToken 回退 10008/10009 → 10010 | 默认不再走假域名和已关闭端口 |
|
||
| Android | `HttpUtil.setBaseUrl`；bootstrap 写入完整 `AppEndpoints.apiAddr` | 启动后 Dio / ApiService 指向 `http://192.168.200.11:10002` |
|
||
| Android | `Urls` 改为 getter | DataSp 写入后 URL 会跟着更新 |
|
||
|
||
未改：`account-service/`、docker、端口、现网数据、`mobile/` 旧工程。
|
||
|
||
## 提交与回退
|
||
|
||
从新到旧回退：先本验收记录，再联网修复。
|
||
|
||
| 主题 | SHA | 文件 |
|
||
|---|---|---|
|
||
| 本验收记录 | 本文件当次提交 | `docs/acceptance/b225-network-fix.md` |
|
||
| 联网修复 | `bbc4dce0b61b44447f84732d841b8a66e3a2f4be` | `pc-client/.env.production`、`pc-client/src/config/endpoints.ts`、PC 调用点、Android Config/Urls/HttpUtil/bootstrap |
|
||
|
||
回退示例（新到旧）：
|
||
|
||
```
|
||
git revert <本验收提交>
|
||
git revert bbc4dce0b61b44447f84732d841b8a66e3a2f4be
|
||
```
|
||
|
||
用户侧继续用旧包 `v1.0.6-internal-test`。不要回退到故障预发布 `v3.8.3-internal-acceptance`。
|
||
|
||
代码侧也可把分支重置回 `18d890ae7fdf66fa4df67360469f0f143641666a`。回退不影响现网服务与已发布旧包。
|
||
|
||
## 环境
|
||
|
||
- Flutter 3.24.5 / Dart 3.5.4（`C:\devtools\flutter_3.24.5`）
|
||
- Temurin JDK 17.0.20
|
||
- Android SDK：platform-tools、platforms;android-34、build-tools;34.0.0
|
||
- Node v24.5.0；`pc-client` `npm install --ignore-scripts` 后 `npm run build` + `npx electron-builder --win --x64`
|
||
- `GRADLE_OPTS=-Xmx4096M`
|
||
|
||
## 候选包（未发布，未覆盖 `v3.8.3-internal-acceptance`）
|
||
|
||
构建基线 HEAD：`18d890ae7fdf66fa4df67360469f0f143641666a` + 本卡两提交。
|
||
|
||
| 产物 | 版本 | 大小 | SHA256 | 路径 |
|
||
|---|---|---|---|---|
|
||
| Android release APK | 3.8.3 | 53,288,459 B | `3709E9B24F2F8B12B9BD931D6633DC101C186367B5C3E704DD91D67DCB791B86` | `mobile-next/build/app/outputs/flutter-apk/app-release.apk` |
|
||
| Windows NSIS EXE | 1.0.2 | 105,893,401 B | `F16B421857C341016E4375A869C53FF80B1028E49F84A59FE43C93D50FCC866C` | `pc-client/release/Base/1.0.2/畅联_1.0.2.exe` |
|
||
|
||
故障预发布对照（不要当候选）：
|
||
|
||
| 产物 | SHA256 |
|
||
|---|---|
|
||
| APK `v3.8.3-internal-acceptance` | `41261A1BEBD00597D16B50A0D01A261AF592129C5F28014B423A1AAE07AE7C73` |
|
||
| EXE `v3.8.3-internal-acceptance` | `25491BA9A19E181144602F81991993DBF3350A3981BD1CC82354949A83B0E645` |
|
||
|
||
产物抽检：
|
||
|
||
- 新 EXE `app.asar`：`http://192.168.200.11:10010` / `:10002` / `ws://...:10001` / `:17880` 各 1 次；`VITE_ACCOUNT_URL`、`{}.VITE_`、`undefined/api/login` 为 0。
|
||
- 新 APK `lib/arm64-v8a/libapp.so`：上述四条公司地址各 1 次；`your-server-ip`、`:10008`、`:10009` 为 0。
|
||
|
||
APK 内嵌时间戳，哈希不可位级复现。构建期告警同前：Flutter Gradle apply-script 弃用；部分依赖 Kotlin metadata 1.8.0 vs 工程预期 1.6.0。均属上游，release 通过。
|
||
|
||
## 已测 / 未测
|
||
|
||
已测：
|
||
|
||
- 构建机到 `192.168.200.11` 的 10001/10002/10010/17880 端口开，10008/10009 关
|
||
- 账号服务对错误工号返回业务 JSON（服务本身在）
|
||
- `npm run build`、`electron-builder --win --x64`、`flutter build apk --release` 成功
|
||
- 新旧产物字符串对照如上
|
||
|
||
未测（不得写成已通过）：
|
||
|
||
- 公司内网真机 / 真 PC 用工号登录
|
||
- 登录后会话列表、发消息、音视频
|
||
- 本候选包安装覆盖旧包后的升级路径
|