同城小程序开发首期只开外卖时若首页仍展示跑腿、团购入口用户点进去空白或 404会被当成系统故障。问题常在业务开关与路由未联动后台关了模块端上菜单仍是写死列表或旧缓存。结论开关 路由拦截 版本号biz_switches home_entries config_version - miniapp filters visible menu - router guard blocks disabled routes配置模型{config_version:20260928.1,biz_switches:{waimai:true,paotui:false},home_entries:[{code:waimai,route:/pages/waimai/index},{code:paotui,route:/pages/paotui/index}]}端侧过滤functionvisibleMenu(config){returnconfig.home_entries.filter((e)config.biz_switches[e.code]);}路由守卫functiononRoute(path,config){constcoderouteToBizCode(path);if(code!config.biz_switches[code]){redirectTo(/pages/closed/index);returnfalse;}returntrue;}禁止只藏图标不拦深链Banner、搜索仍可能链到未开通页。版本刷新asyncfunctionrefreshConfig(localVer){constremoteawaitfetch(/api/config?ver${localVer});if(remote.versionlocalVer){storage.set(cfg,remote);rebuildHomeMenu(remote);}}验收用例用例 A仅外卖开跑腿路由不可达。用例 B后台开跑腿无发版菜单出现。用例 C关闭跑腿历史单仍可查若策略要求。与 W8 差异说明本文聚焦未开通业务可见性与路由拦截不重复会话绑定与接单状态机见其他篇。光合同城边界光合同城成品支持业务开关与端入口联动统一后台配置私有化交付。小结同城小程序开发暂时不用的业务用户不应能点进去开关、菜单、路由三层一致比事后解释「还没开」更省客服。Deep link 与分享路径functionhandleShareEntry(path,config){if(!onRoute(path,config))return;navigateTo(path);}分享卡片带入的路径必须先过onRoute否则用户从群链接直达未开通页。Banner 与搜索Bannerlink_target映射biz_code渲染前if (!config.biz_switches[code]) skip。搜索建议过滤未开通业务 SKU。进行中订单例外关闭业务入口时用户「我的订单」仍可见历史单详情产品策略可选仅禁止新建单。路由 guard 要区分 list 与 create。自动化测试deftest_paotui_hidden_when_switch_off(client):cfgload_config(biz_switches{paotui:False})assertclient.get(/pages/paotui/index).status302assertwaimaiinclient.get_home().menu_codes与 config CDN配置 JSON 可走 CDN但必须带config_versionquery变更后 CDN 刷新或短 TTL≤60s避免开关关了用户仍看旧菜单。小结补述同城小程序开发未开通业务不可达靠开关 菜单过滤 路由 guard 深链拦截四层少一层就会多一类「点进去坏了」的投诉。交付清单建议上线前宜书面确认未开通业务深链拦截截图、config_version 变更后菜单刷新录屏、进行中单例外策略若有。三项归档后再对外宣称「首期仅外卖」之类范围避免演示全开与交付范围不一致引发纠纷。用户从分享链接点进未开通页同城小程序开发首期只开外卖时Banner、搜索、分享卡片仍可能把用户带到跑腿页。只藏首页图标不够深链与分享路径必须先过路由守卫。运营在活动里放了「即将开通」链接若守卫未拦用户会当成系统故障投诉。后台关闭模块后端上宜在较短时间内刷新配置版本避免旧菜单缓存。进行中订单策略要事先写清关闭入口后历史单是否仍可查详情。验收时走三条路径首页菜单不可见、深链被拦截、后台重新开通后菜单无发版出现。少测一层就多一类「点进去坏了」的工单。配置走 CDN 时宜短 TTL 或版本号 query避免开关已关用户仍看旧菜单。自动化测试宜覆盖开关关、深链拦、开开关无发版菜单出现三条用例纳入 CI。活动链接也要过路由守卫运营配置的 Banner 与搜索跳转映射到业务代码后渲染前检查开关。分享卡片带入的路径必须先过守卫否则用户从群链接直达未开通页。自动化用例纳入持续集成避免下次改首页又漏测深链。交付归档宜附深链拦截截图。