修复小程序讲解页面返回回退

tests/unit/ExplainGuideStopListNavigation.spec.ts

@@ -7,15 +7,35 @@ import ExplainGuideStopListPage from '@/pages/explain/guide-stop-list.vue'
 import { explainUseCase } from '@/usecases/explainUseCase'
 
 const testState = vi.hoisted(() => ({
-  onLoadHandler: null as null | ((options?: Record<string, string>) => void)
+  onLoadHandler: null as null | ((options?: Record<string, string>) => void),
+  onBackPressHandler: null as null | (() => boolean)
+}))
+
+const hostEnvironmentMocks = vi.hoisted(() => ({
+  embeddedInWechatMiniProgram: false
+}))
+
+const miniProgramReturnMocks = vi.hoisted(() => ({
+  returnToWechatMiniProgram: vi.fn(() => Promise.resolve({ status: 'failed' as const, reason: 'bridge-unavailable' as const }))
 }))
 
 vi.mock('@dcloudio/uni-app', () => ({
   onLoad: (handler: (options?: Record<string, string>) => void) => {
     testState.onLoadHandler = handler
+  },
+  onBackPress: (handler: () => boolean) => {
+    testState.onBackPressHandler = handler
   }
 }))
 
+vi.mock('@/utils/hostEnvironment', () => ({
+  isEmbeddedInWechatMiniProgram: () => hostEnvironmentMocks.embeddedInWechatMiniProgram
+}))
+
+vi.mock('@/services/WechatMiniProgramBridgeService', () => ({
+  returnToWechatMiniProgram: () => miniProgramReturnMocks.returnToWechatMiniProgram()
+}))
+
 vi.mock('@/usecases/explainUseCase', () => ({
   explainUseCase: {
     listGuideStopsPageByHall: vi.fn().mockResolvedValue({
@@ -53,6 +73,10 @@ const mountGuideStopList = () => mount(ExplainGuideStopListPage, {
 
 beforeEach(() => {
   testState.onLoadHandler = null
+  testState.onBackPressHandler = null
+  hostEnvironmentMocks.embeddedInWechatMiniProgram = false
+  miniProgramReturnMocks.returnToWechatMiniProgram.mockReset()
+  miniProgramReturnMocks.returnToWechatMiniProgram.mockResolvedValue({ status: 'failed', reason: 'bridge-unavailable' })
   vi.stubGlobal('uni', {
     navigateBack: vi.fn(),
     reLaunch: vi.fn(),
@@ -155,6 +179,19 @@ describe('讲解对象列表返回', () => {
     wrapper.unmount()
   })
 
+  it('小程序直达展厅时返回宿主，不重启 H5 展厅列表', async () => {
+    hostEnvironmentMocks.embeddedInWechatMiniProgram = true
+    miniProgramReturnMocks.returnToWechatMiniProgram.mockResolvedValue({ status: 'returned' })
+    const wrapper = mountGuideStopList()
+
+    await wrapper.get('[data-testid="list-back"]').trigger('click')
+    await flushPromises()
+
+    expect(miniProgramReturnMocks.returnToWechatMiniProgram).toHaveBeenCalledTimes(1)
+    expect(uni.reLaunch).not.toHaveBeenCalled()
+    wrapper.unmount()
+  })
+
   it('页面栈返回失败时回退至独立展厅列表', async () => {
     vi.stubGlobal('getCurrentPages', vi.fn(() => [
       { route: 'pages/explain/list', options: {} },