From af67ad6147800468ab2b101c5a4cc361cb1fd35b Mon Sep 17 00:00:00 2001
From: zyj <zyj@local>
Date: 星期日, 13 九月 2026 23:39:44 +0800
Subject: [PATCH] docs(工作日结): 补记 2026-09-13 《运距异常分析》分析报告（出版）重写与文件误覆盖恢复

---
 docs/功能测试报告/功能测试报告_部署包打包与独立启动_2026-09-13.md |   91 +++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 91 insertions(+), 0 deletions(-)

diff --git "a/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\351\203\250\347\275\262\345\214\205\346\211\223\345\214\205\344\270\216\347\213\254\347\253\213\345\220\257\345\212\250_2026-09-13.md" "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\351\203\250\347\275\262\345\214\205\346\211\223\345\214\205\344\270\216\347\213\254\347\253\213\345\220\257\345\212\250_2026-09-13.md"
new file mode 100644
index 0000000..392db91
--- /dev/null
+++ "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\351\203\250\347\275\262\345\214\205\346\211\223\345\214\205\344\270\216\347\213\254\347\253\213\345\220\257\345\212\250_2026-09-13.md"
@@ -0,0 +1,91 @@
+# 鍔熻兘娴嬭瘯鎶ュ憡_閮ㄧ讲鍖呮墦鍖呬笌鐙珛鍚姩_2026-09-13
+
+## 涓�銆佸姛鑳借鏄�
+
+鐢ㄦ埛闇�瑕佹妸绯荤粺鎵撳寘閮ㄧ讲鍒板彟涓�鍙版満鍣ㄣ�傛湰杞氦浠樹笁浠朵簨锛�
+
+### 1. 涓�閿墦鍖呰剼鏈� `package-deploy.py`锛堟柊澧烇級
+
+涓�鏉″懡浠ゅ畬鎴愶細鍓嶇鏋勫缓 鈫� 鎶� `dist` 鍐呭祵杩涘悗绔� jar锛堟嫹杩� `src/main/resources/static`锛夆啋 `mvn clean package` 鈫� 娓呯┖ static锛堜繚鎸佷粨搴撳共鍑�锛夆啋 缁勮閮ㄧ讲鐩綍 鈫� 鍘嬬缉 zip銆�
+
+浜х墿锛�
+- 鐩綍 `deploy/traffic-audit-deploy-YYYYMMDD/`
+- 鍘嬬缉鍖� `traffic-audit-deploy-YYYYMMDD.zip`锛堟湰娆� 69.9 MB / 246 涓枃浠讹級
+
+閮ㄧ讲鐩綍缁撴瀯锛堟部鐢� 8 鏈堢増鍖呬範鎯級锛�
+
+```
+backend/  jar锛堝惈鍐呭祵鍓嶇锛�+ docs/ + application.yml + start-backend.cmd/.sh
+frontend/ dist/ + nginx.conf.example        锛堜粎 nginx 鏂规闇�瑕侊級
+db/       init.sql + sql_city_bus.sql + sql_city_taxi.sql + sql_wyc.sql
+README-閮ㄧ讲璇存槑.txt
+```
+
+### 2. 淇 `JwtUtils`锛歚jwt.secret` 闈炴硶 Base64 瀵艰嚧鐧诲綍 500锛堟牴鍥犱慨澶嶏級
+
+- 鐜拌薄锛堟湰娆＄儫娴嬪疄娴嬶級锛氭妸澶栫疆 `application.yml` 鐨� `jwt.secret` 濉垚涓枃涓插悗锛岀櫥褰曟帴鍙ｈ繑鍥� `500 {"code":500,"message":"20018"}`銆�
+- 鏍瑰洜锛歫jwt 0.9.1 榛樿鎶� secret 褰� **Base64** 瑙ｇ爜锛岄潪娉曞瓧绗︿細鍦� `DatatypeConverter.guessLength` 鎶�
+  `ArrayIndexOutOfBoundsException`锛岃 `GlobalExceptionHandler` 鍏滄垚 500銆傞儴缃插悓浜嬬涓�娆℃敼閰嶇疆寰堝鏄撹俯銆�
+- 澶勭疆锛歚JwtUtils` 鏂板 `secretKeyBytes()`鈥斺�旇兘鎸� Base64 瑙ｇ爜灏辩敤瑙ｇ爜缁撴灉锛堜笌鍘嗗彶 token 鍏煎锛夛紝鍚﹀垯鎸� UTF-8 瀛楄妭澶勭悊骞舵墦 WARN銆�
+
+### 3. 鏇存銆婃墦鍖呴儴缃茶鏄庛�嬶紙`docs/鎵撳寘閮ㄧ讲璇存槑.md`锛�
+
+鏃х増锛�2026-08-27锛夋湁涓夊涓庣幇鐘朵笉绗︼紝鏈涓�骞舵敼姝ｏ細
+
+| 鏃ц鏄� | 瀹為檯鎯呭喌 | 澶勭悊 |
+|--------|----------|------|
+| 銆孯edis 鍚庣鍚姩蹇呴渶銆� | pom 鏃� redis 渚濊禆锛屼唬鐮佷篃鏈娇鐢� | 鏀逛负銆屼笉闇�瑕� Redis銆嶏紝骞跺幓鎺夊缃厤缃噷鐨� redis 娈� |
+| 銆宩ar 宸插唴缃墠绔潤鎬佹墭绠★紙file:./web/锛夈�� | jar 鍐呮棤浠讳綍闈欐�佹枃浠讹紝涔熸病鏈� `static-locations` 閰嶇疆锛涙棫鍖呭疄闄呴潬 nginx | 鏀逛负銆屾墦鍖呮椂鎶� dist 鍐呭祵杩� jar銆嶏紝璁块棶 8090 鍗冲彲锛屾棤闇� nginx |
+| 鏁版嵁搴撳彧鎻� 3 涓剼鏈� | 鐜扮綉杩樻湁 `wyc_total_monthly` / `wyc_order_monthly` 涓ゅ紶琛� | 琛� `db/sql_wyc.sql`锛屽苟琛ュ厖 `summary.template-dir` 绛夐厤缃笌鏃跺簭 |
+
+## 浜屻�佹祴璇曠幆澧�
+
+- 寮�鍙戞満锛氬悗绔� 8090锛坄start-dev.ps1`锛岄噸鍚悗 PID 鍙樺寲锛夈�佸墠绔� 8080銆丮ySQL 127.0.0.1:3308銆�
+- 閮ㄧ讲鍖呴獙璇侊細鎶� `deploy/traffic-audit-deploy-20260913/backend` 鎷峰埌 `_deploytest/`锛岀敤 **8091** 绔彛鐙珛鍚姩
+  锛堟暟鎹簱鐢ㄥ懡浠よ鍙傛暟瑕嗙洊涓� 3308锛屾ā鎷熴�屽缃� yml + 鍛戒护琛岃鐩栥�嶄袱绉嶆敼閰嶇疆鏂瑰紡锛夈��
+- 娴嬭瘯鏃堕棿锛�2026-09-13锛涜剼鏈細`package-deploy.py`銆乣_deploy_smoke.py`锛堢粨鏋� `_deploytest_result.txt`銆乣_deploytest_backend.log`锛夈��
+
+## 涓夈�佺敤渚嬭〃
+
+### 3.1 姝ｅ悜鐢ㄤ緥
+
+| 缂栧彿 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- |
+| TC-1 | `python package-deploy.py --no-build` | 浜у嚭 zip锛屼笖鏃犳姤閿� | `traffic-audit-deploy-20260913.zip` 69.9 MB / 246 鏂囦欢 | 閫氳繃 |
+| TC-2 | 妫�鏌� jar 鍐呭 | 鍚唴宓屽墠绔� | jar 55.5 MB锛宍BOOT-INF/classes/static/` 涓� 42 涓枃浠讹紝`static/index.html` 瀛樺湪 | 閫氳繃 |
+| TC-3 | 妫�鏌ラ儴缃茬洰褰曠粨鏋� | backend/frontend/db/README 榻愬叏 | backend锛坖ar + docs + application.yml + 2 涓惎鍔ㄨ剼鏈級銆乫rontend/dist銆乨b 4 涓� sql銆丷EADME | 閫氳繃 |
+| TC-4 | 鎵撳寘鍚庢簮鐮佺洰褰� | `src/main/resources/static` 搴旇娓呯┖ | 鎵撳寘缁撴潫鑷姩娓呯┖锛堜粨搴撴棤姹℃煋锛� | 閫氳繃 |
+| TC-5 | 浠庨儴缃插寘鐙珛鍚姩锛�8091锛� | 鍚姩鎴愬姛 | 鏃ュ織鍑虹幇 `Started TrafficAuditApplication`銆乣Tomcat started on port(s): 8091` | 閫氳繃 |
+| TC-6 | `GET /` | 200 涓旇繑鍥為〉闈� | 200锛�1828 瀛楄妭锛屽惈 `<div id="app">` | 閫氳繃 |
+| TC-7 | `GET /js/app.*.js` | 200锛堥潤鎬佽祫婧愬彲璁块棶锛� | 200锛�6253 瀛楄妭 | 閫氳繃 |
+| TC-8 | `POST /api/auth/login`锛坅dmin/123456锛� | 200 涓旇繑鍥� token | 200锛宍{"code":200,"message":"success","data":{...,"token":"eyJ..."}}` | 閫氳繃 |
+| TC-9 | 甯� token 瀵煎嚭銆婇亾璺繍杈撻噺姹囨�昏〃銆�2026-08 | 200 涓旀槸鍚堟硶 xlsx | 200锛�950,783 瀛楄妭锛屽ご閮� `PK`锛堜笌寮�鍙戞満瀵煎嚭浠跺悓灏哄锛� | 閫氳繃 |
+
+### 3.2 璐熷悜鐢ㄤ緥
+
+| 缂栧彿 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- |
+| TC-N1 | 淇鍓嶏細`--jwt.secret=杩欐槸涓�涓腑鏂囧瘑閽 | 鏆撮湶闂 | 鐧诲綍 500锛屾棩蹇� `ArrayIndexOutOfBoundsException: 20018 at JwtUtils.generateToken` | 宸插鐜帮紙闂鎴愮珛锛� |
+| TC-N2 | 淇鍚庯細鍚屾牱浼犱腑鏂� secret | 涓嶅洜瀵嗛挜鏍煎紡宕╋紝鐧诲綍浠嶅彲鐢� | 鐧诲綍 200 鎷垮埌 token锛涘鍑哄悓鏍� 200 / 950,783 瀛楄妭锛涙棩蹇楀嚭鐜般�宩wt.secret 涓嶆槸鍚堟硶鐨� Base64 瀛楃涓测�︺�峎ARN | 閫氳繃 |
+| TC-N3 | 澶栫疆 application.yml 淇濈暀鍗犱綅瀵嗙爜锛岀敤鍛戒护琛� `--spring.datasource.password` 瑕嗙洊 | 鍛戒护琛岃鐩栫敓鏁� | 鍚姩鎴愬姛骞舵甯告煡搴擄紙鐧诲綍 200锛� | 閫氳繃 |
+| TC-N4 | 鎵撳寘鑴氭湰閲嶅鎵ц锛堟棫 staging 鐩綍鍚彧璇绘枃浠讹級 | 鑳芥竻鐞嗗苟閲嶅缓 | 棣栬疆鎶� `PermissionError WinError 5`锛屽姞 `rmtree_force`锛堝厛娓呭彧璇诲睘鎬э級鍚庢甯� | 宸蹭慨澶� |
+
+### 3.3 鍥炲綊鐢ㄤ緥
+
+| 缂栧彿 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- |
+| TC-R1 | 寮�鍙戞満閲嶅惎鍚庣锛堣浇鍏� JwtUtils 鏀瑰姩锛� | 鍔熻兘涓嶅洖褰� | 鐧诲綍 200锛涘鍑� 2026-08 鈫� HTTP 200 / 950,783 瀛楄妭锛堜笌閮ㄧ讲鍖呬骇鐗┿��9-13 褰掓。浠跺悓灏哄锛� | 閫氳繃 |
+| TC-R2 | 鍓嶇鐢熶骇鏋勫缓 | 鏋勫缓鎴愬姛 | `npm run build` 鎴愬姛锛宍dist/index.html` + css/js/fonts 榻愬叏 | 閫氳繃 |
+
+## 鍥涖�佸彂鐜扮殑闂涓庡缃�
+
+1. **`jwt.secret` 闈炴硶 Base64 鈫� 鐧诲綍 500**锛堢儫娴嬫姄鍒帮級锛氬凡鎸夋牴鍥犱慨澶嶏紙Base64 浼樺厛銆佸惁鍒� UTF-8 鍏滃簳 + WARN锛夛紝骞跺湪鎵撳寘閰嶇疆閲岀粰鍑哄彲鐩存帴浣跨敤鐨� 32 浣嶅崄鍏繘鍒剁ず渚嬪�笺�佸湪璇存槑鏂囨。閲屽啓鏄庡彇鍊艰鍒欍��
+2. **鎵撳寘鑴氭湰娓呯悊鏃х洰褰曡鍙鏂囦欢鎸′綇**锛氭簮 `docs` 閲屾湁鍙 xlsx锛宍copy2` 浼氭妸鍙灞炴�у甫杩囧幓锛屽鑷� Windows 涓� `rmtree` 鎶ャ�屾嫆缁濊闂�嶁啋 鏂板 `rmtree_force()` 鍏� `chmod` 鍐嶅垹銆�
+3. **鏃с�婃墦鍖呴儴缃茶鏄庛�嬩笁澶勪笉瀹�**锛圧edis 蹇呴渶 / jar 宸插唴缃墠绔� / 缂� sql_wyc.sql锛夛細宸插叏閮ㄦ洿姝ｏ紝骞惰ˉ涓婇儴缃插悗楠岃瘉娓呭崟涓庡父瑙侀棶棰樸��
+4. 璇存槑锛氱儫娴嬭剼鏈噷銆屾嬁鍒� token銆嶉偅涓�椤规墦鍗颁负 False锛屾槸鑴氭湰鎶婂搷搴斾綋鎴柇鍒� 120 瀛楃鍚庡啀鍒ゆ柇瀛楃涓插鑷达紙鎴柇鍚庣湅涓嶅埌 `"token"`锛夛紝鍘熷鍝嶅簲涓庡悗缁甫 token 鐨勫鍑鸿姹傚潎鎴愬姛锛圚TTP 200锛夛紝绋嬪簭鏈韩鏃犻棶棰樸��
+
+## 浜斻�佺粨璁�
+
+- 鎵撳寘鑴氭湰涓�閿彲浜у嚭鍙洿鎺ラ儴缃茬殑 zip锛涢儴缃插寘鍦�**鑴辩婧愮爜鐩綍**銆佷粎闈� jar + docs + 澶栫疆閰嶇疆鐨勫墠鎻愪笅锛岀嫭绔嬪惎鍔ㄣ�侀〉闈�/闈欐�佽祫婧�/鐧诲綍/瀵煎嚭鍏ㄩ儴閫氳繃锛屽鍑轰骇鐗╀笌寮�鍙戞満涓�鑷达紙950,783 瀛楄妭锛夈��
+- `jwt.secret` 鐨勯儴缃查櫡闃卞凡鏍瑰洜淇锛岄儴缃插悓浜嬪嵆浣垮～浜嗕笉瑙勮寖鐨勫�间篃涓嶄細鍐嶅嚭鐜般�岀櫥褰� 500銆嶈�屾棤浠庝笅鎵嬨��
+- 閮ㄧ讲璇存槑宸蹭笌褰撳墠浠ｇ爜瀵归綈锛堜笉闇�瑕� Redis銆佷笉闇�瑕� nginx銆�4 涓缓琛ㄨ剼鏈�佸缃厤缃」榻愬叏锛夈��

--
Gitblit v1.9.1