gitlab-instance-0a899031_digital/BUGS_AND_ISSUES_SUMMARY.md

Bug 与问题总结

基于代码分析，发现并已修复/待关注的问题如下。

---

一、已修复的 Bug

1. digital 首页登录注册异常

问题	原因	修复
登录/注册后状态异常	Cookie 未设置 domain，跨子域失效	新增 auth-cookie.ts，生产环境支持 AUTH_COOKIE_DOMAIN
auth/me 校验失败	使用已废弃的 /api/users/refresh	改为 POST /api/collections/users/auth-refresh
AuthModal 类型错误	pbSaveAuth 传入 record 的 email 可能为 undefined	显式传入 { id, email: email ?? "" }

2. cnomadcna 首页「加入游牧中国」流程不完整

问题	原因	修复
老用户有 VIP 仍被要求支付	check-user 只返回 exists，未返回 vip	payjsapi 扩展 check-user 返回 vip、user_id
无 VIP 状态判断	前端未按 vip 分支处理	HeroSection 在 exists 且 vip 时提示「您已是会员」

3. cnomadcna 支付成功后首页未显示登录

问题	原因	修复
支付完成返回首页仍显示未登录	join/paid 未同步 localStorage，Navbar 不刷新	join/paid 调用 pbSaveAuth 并派发 auth:updated，Navbar 监听并 refetch

4. cnomadcna /join 提交申请

问题	原因	修复
未登录可提交	getOrCreateUserId 无 cookie 时返回假 ID	未登录返回 401，强制先登录
solan 未关联真实用户	使用 user${Date.now()} 作为 user_id	使用 cookie 中的真实 userId

5. 环境与配置

问题	原因	修复
payjsapi 端口不一致	默认 8700，用户期望 8007	run.py 支持 PORT 环境变量，默认 8007
各项目默认支付 API 端口	domain.config 使用 8700	统一改为 127.0.0.1:8007

---

二、潜在风险与待关注点

1. PocketBase 管理员认证

• 现象：check-user、ensure-user、vip/check 依赖 POCKETBASE_EMAIL、POCKETBASE_PASSWORD
• 风险：未配置时返回「服务配置错误」或 vip 始终为 false
• 建议：确保各项目 .env.local 中正确配置管理员账号

2. ZPAY 回调地址

• 现象：payjsapi 的 BASE_URL 需为 ZPAY 可访问的公网地址
• 风险：本地调试时 ZPAY 无法回调 localhost/内网，支付成功但 PocketBase 不更新
• 建议：本地测试可用 ngrok 暴露 8007，或部署到公网后测试回调

3. 跨域 Cookie

• 现象：digital/meetup/vip 三站共享登录需 AUTH_COOKIE_DOMAIN=.hackrobot.cn
• 风险：生产环境未配置时，各子域登录态不共享
• 建议：生产部署时在 .env.local 中设置 AUTH_COOKIE_DOMAIN=.hackrobot.cn

4. cnomadcna 新用户预创建逻辑

• 现象：isPrivateDevHost 时新用户会先 ensure-user 再支付，生产环境用 pending_hex(email) 作为 user_id
• 风险：生产环境新用户支付成功后才创建 users，逻辑正确；本地预创建可能掩盖问题
• 建议：保持现状，本地与生产流程略有差异

5. digital 支付 return_url

• 现象：course 页「立即报名」的 return_url 为 /course/0/0
• 风险：支付返回后需轮询支付状态，usePayStatusPoll 依赖 join_pay_order cookie；digital 的 pay 路由可能未设置该 cookie
• 建议：确认 digital 支付返回后 course 页能正确轮询并刷新 VIP 状态

---

三、代码质量与结构

类型	说明
重复逻辑	三个前端的 auth、pay、vip 逻辑相似，可考虑抽公共库
硬编码	部分文案、金额、URL 散落代码中，建议集中到 config
错误处理	部分 API 的 catch 仅 console.error，未统一错误格式
类型安全	AuthModal 等处的 record 类型可再收紧

---

四、本次修改项（当前会话）

1. 支付测试价格：所有前端默认 1 元（100 分）
2. 默认 zpay 渠道：各项目 .env.local 设置 PAYMENT_PROVIDER=zpay，cnomadcna 默认 channel 改为 alipay
3. .env.local：为 digital、cnomadcna、nomadvip、payjsapi 创建本地调试配置
4. cnomadcna 支付页：/api/pay 返回的 HTML 使用 opacity:0 隐藏「正在跳转」提示，直接进入支付流程