3dtours/SonicForgeStudio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
SonicForgeStudio/native_bridge/debug/BUG_REPORT.md
T

7.5 KiB
Raw Permalink Blame History

BÁO CÁO BUG: Mở VST GUI khi đang PLAY → dự án câm, GUI không load

Ngày: 2026-08-15 · Repo: C:/Users/locpham/SonicForgeStudio · git status sạch

1. Tóm tắt

Nguyên nhân gốc: nhiều thread cùng vào 1 plugin DLL trong lúc view->attached(). Khi đang PLAY, audio loop process() chạy trên các instance Nexus (ch0-4) cùng lúc worker thread của ch5 chạy attachView(). Nexus throw exception trong createView/attached → attach FAILED → frontend retry ~30 lần (0.3s/lần) → bridgeWriteIndex stall 3s → Tauri watchdog kill+respawn bridge → mất hết instrument → câm toàn bộ. GUI không bao giờ load được.

Không phải "instrument track khác bị reset" (giả thuyết 1 sai ở bước này — reload reset state chỉ xảy ra khi GUI ĐÃ mở thành công rồi đóng rồi mở lại, không phải lần attach đầu).

2. Chuỗi bug đầy đủ (xác nhận live, bridge.log)

... 6x Nexus loaded ch0-5 + EZkeys ch6 ...
[NativeBridge] transport PLAY playhead=0
[NativeBridge] GUI attach EXCEPTION ch=5 — plugin threw (createView/attached)
[NativeBridge] GUI attach FAILED hwnd=0000000002250F36 plugin=Nexus
[tauri] bridge restarted (attempt 1)      ← watchdog: writeIndex stall 3s
[NativeBridge] Starting DAW Host Bridge Engine...   ← restart, mất hết instrument
  1. handleOpenGui (main.cpp ~943): OPEN_GUI ch5 → silence mọi channel cùng plugin path → g_loadMutex → try { reloadForGUI(); attachView(hwnd); } catch(...).
  2. attachView (Vst3Instrument.cpp:550): controller->createView(kEditor) → view->attached(hwnd, kPlatformTypeHWND) → Nexus throw khi đang PLAY (audio loop process() cùng DLL đang chạy trên instance khác).
  3. catch → ok=false → log EXCEPTION + FAILED → PostMessage WM_CLOSE (GUI không load).
  4. Frontend openVstGuiRetry spam lại ~30 lần; mỗi lần chạy lại job (silence + mutex + reload/attach) → main loop bị nghẽn → bridgeWriteIndex stall 3s.
  5. lib.rs: stall >3s → kill_bridge + spawn_bridge (restart_attempts==0) → mất toàn bộ instrument state → CÂM.

3. Bằng chứng thực nghiệm

3.1 Probe kiến trúc chính xác (bridge_two: 2 worker STA riêng + main pump)

gui_probe.exe <plugin> bridge_two <secs> — kết quả 76 VST3 hệ thống (sweep): native_bridge/debug/sweep_bridge_two_8s.json, probe_attach_detail.py (bổ sung).

⚠️ Hiệu chỉnh sweep cũ: exit code 0xC0000409 của TẤT CẢ 76 plugin là artifact của probe — ProbeWorker::th không join → ~std::thread trên joinable thread → std::terminate → fail-fast. RESULT line in ra nhưng không flush kịp. Không phải 76 plugin cùng crash teardown.

Phân loại đúng dựa trên output per-attach:

Nhóm Số plugin Bằng chứng Ý nghĩa
HANG attach inst2 30 workerA openGUI inst1=1 rồi workerB openGUI inst2 in ra, không có kết quả — Nexus 25s không về 2 instance cùng DLL, 2 apartment → attach instance 2 HANG trong view->attached()
BOTH-OK 20 workerB openGUI inst2=1 — Kontakt, BlueARP, Ozone 11 (18) Attach 2 instance OK; chỉ crash teardown artifact
HANG/crash attach inst1 18 workerA hwnd= in ra, không in openGUI inst1 — RX 11 (18) + ACTP Chết ngay instance 1
CRASH EARLY 8 exit 1.2-4.6s, 0xC0000005 (AV): Melodyne, Orb Arpeggios/Melody, smartEQ3/live, smartreverb, DUNE3, ACDD Crash thật trong attach

Không plugin nào HANG >18s (không WATCHDOG-KILL) — main pump cứu được các trường hợp cần pump; vấn đề là conflict thread/apartment khi 2 instance cùng DLL.

3.2 Nexus: hang khi 2 instance — OK khi 1 thread

  • bridge_two (2 worker STA, 2 instance Nexus): inst1 attach OK, inst2 HANG 25s+ (xác nhận bằng run 25s).
  • same_thread (load + attach cùng 1 thread): OK (returned=1).
  • main_own (load+attach main thread): OK (RESULT done=1 attached_ok=1).
  • two_workers_close (đóng editor inst1 trước khi attach inst2, có closeGUI + attach qua temp thread): Nexus HANG ngay attach inst1; Kontakt chạy hết, OK cả 2.

→ 2 thread/apartment cùng 1 DLL = conflict thật (không riêng Nexus: 30 plugin hang inst2, 8 crash AV). Kontakt/Ozone/BlueARP chịu được.

3.3 Giả thuyết (a) reload mất state — XÁC NHẬN từ code

Vst3Instrument::reload() (Vst3Instrument.cpp:615): closeGUI() + terminate + delete state_ + loadPlugin(path_) MỚI → preset/state mất khi mở lại GUI (reopen). Kích hoạt bởi reloadForGUI() khi hasAttachedOnce_ && !guiAttached_ (đã từng mở GUI rồi đóng). Không phải nguyên nhân của bug câm lần này (attach đầu chưa thành công nên chưa tới reload), nhưng là bug phụ: mở GUI → đóng → mở lại = mất preset/state của track.

4. Kết luận nguyên nhân

  1. Root cause: attach GUI chạy worker thread trong khi audio loop process() đang chạy instance cùng DLL (2+ thread 1 DLL). Nexus throw → attach fail. Probe không audio: biểu hiện hang (inst2); app thật có audio: biểu hiện exception (ch5). Cùng gốc.
  2. Khuếch đại: frontend retry spam 30× → stall 3s → watchdog tưởng bridge chết → restart → mất hết instrument → câm. Đây là lý do dự án chết hoàn toàn, không chỉ mất GUI.
  3. g_loadMutex + silence hiện có chưa đủ: không đợi renderAll thoát hẳn instance cùng DLL trước khi createView, và Nexus vẫn throw ngay cả khi đã silence (silence chỉ ngăn process gọi tiếp, không chặn instance đang nằm trong process()).

5. Đề xuất fix (xếp theo ưu tiên)

  1. Chặn/defer OPEN_GUI khi transport PLAY — đơn giản nhất, an toàn nhất: nếu đang PLAY, đợi transport STOP (hoặc tự tạm dừng) trước khi attach, resume sau. Loại bỏ hoàn toàn conflict audio-loop × attachView. (ponytail: người dùng muốn mở GUI khi đang chơi thì nâng cấp thành pause-resume tự động, hoặc đợi setProcessing(false) + đợi renderAll thoát.)
  2. Giới hạn retry: bỏ openVstGuiRetry spam; thử tối đa 2-3 lần có backoff.
  3. Watchdog đừng giết khi đang attach GUI: phân biệt stall do GUI job dài (có attach-in-flight flag) với stall do bridge chết thật; nâng ngưỡng stall khi có attach đang chạy.
  4. Fix state reset: reload() nên save/restore state (getState/setState) thay vì load instance mới mất preset. (Bug phụ, độc lập.)
  5. (Dài hạn) 1 apartment chung cho mọi instance cùng DLL (shared_worker pattern đã có trong probe) — loại conflict nhiều-thread-1-DLL triệt để.

6. Files liên quan

  • native_bridge/src/main.cpp — handleOpenGui (943), silence/close-other (1015-1090), attach job + catch (1132-1160)
  • native_bridge/src/Vst3Instrument.cpp — reload() (615), reloadForGUI() (528), attachView() (550), closeGUI() (640)
  • native_bridge/src/gui_probe.cpp — probe bridge_two (243), two_workers_close (318)
  • native_bridge/debug/ — sweep_all_gui.py, sweep_bridge_two_8s.json, probe_attach_detail.py, probe_app4_live.py, probe_app4.py
  • Bridge log: %AppData%/SonicForgeDAW/logs/bridge.log

Trạng thái live hiện tại: app câm (bridge 21932 sống, không instrument, transport STOP). Test thêm bằng probe_app4_live.py sẽ lại làm hư session — cần xác nhận trước khi chạy tiếp.

Reference in New Issue View Git Blame Copy Permalink