Files
zyt/artifacts/im-chat-cache-permission-audit.md
T
2026-10-22 11:02:57 +08:00

11 KiB
Raw Blame History

聊天记录同步缓存权限审计

日期:2026-10-20。范围:本地源码、项目部署说明和调度配置;未连接线上服务器,未执行修复或业务同步。排除了 public、vendor、node_modules、runtime;本报告不包含环境变量值或凭据。.trellis/ 当前不存在;已读取根 AGENTS.md。

结论

server/runtime/cache/la 下 file_put_contents(...): Permission denied 与本项目默认文件缓存配置一致。聊天同步在 HTTP 和 CLI 中都会写同一套 Cache 检查点;调度器直接在当前进程调用业务命令,不切换身份。若线上系统 cron / 宝塔任务以 root 执行 php think crontab,而 PHP-FPM worker 为 www,root 创建的缓存目录或文件会令后续 www 写入失败。 这是源码能够支持的主要假设;必须结合线上文件属主、权限、ACL、实际调度用户完成确认,不能仅凭报错断言 root 是唯一原因。

持久修复应把同一应用的 PHP-FPM、系统 cron、常驻 worker、部署中的 PHP 命令统一为已确认的应用用户,再修复已有缓存归属。只执行一次 chown 而继续让 root 定时写缓存会复发。该故障通常无需修改聊天同步业务代码。

主线程现场反馈(本子任务未独立连接服务器复核):PHP-FPM 用户确认为 www;runtime/cache/la/06、runtime/cache/la/09 均为 root:root、0755;root 的宝塔 cron 同时存在 php think crontab、sync_im_chat_archive。这组证据已确认 root 调度与 www Web 进程共写文件缓存导致的权限冲突。主线程负责备份调度脚本、统一 PHP 执行用户和修复缓存归属。

证据与文件位置

文件和行号 观察 含义
server/config/cache.php:9 default 为 env('cache.driver', 'file') 未覆盖配置时采用文件缓存;实际驱动仍需线上确认。
server/config/cache.php:17、:19 文件缓存 path 为空、prefix 为 la 符合报错中的 runtime/cache/la 路径。未读取 vendor,因此不将具体散列目录规则当作已验证事实。
server/app/adminapi/controller/tcm/DiagnosisController.php:491、:498、:499 调用分页同步,捕获 Throwable 后返回“聊天记录同步失败:”加原异常 PHP 缓存权限异常会原样成为用户看到的同步失败消息。
server/app/adminapi/logic/tcm/DiagnosisLogic.php:1094、:1100 读写 im_chat_sync:<token>,TTL 3600 秒 HTTP 每一步同步都依赖缓存写入。
server/app/adminapi/logic/tcm/DiagnosisLogic.php:1133、:1159 读写 im_chat_complete_v1:<patient>:<account>,TTL 86400 秒 HTTP 和 CLI 共用会话完成检查点;不是单纯网页独有的缓存。
server/app/adminapi/logic/tcm/DiagnosisLogic.php:1175 CLI 也调用 advanceImChatSync() CLI 能以不同 OS 用户创建上述缓存目录和文件。
server/app/adminapi/logic/tcm/DiagnosisLogic.php:1192、:1200、:1209 批量补拉读写 im_chat_archive_batch_cursor:<sinceDays>,永久缓存 定时批处理还有额外文件缓存写入口。
server/app/common/command/SyncImChatArchive.php:21、:42 注册 sync_im_chat_archive,调用批量同步 这是具体定时补拉入口。
server/app/common/command/SyncImChatArchive.php:45–:50 记录错误并抛 RuntimeException 归档失败会暴露为任务错误,不是成功返回。
server/app/common/command/Crontab.php:75、:77 通过 Console::call() 在当前进程执行命令 任务继承调度器的 OS 用户;数据库任务定义不负责切换 www。
server/app/common/command/Crontab.php:81–:86 IM 归档失败后继续保持 START 权限未修复时会反复失败;其他任务可能进入 ERROR。
server/config/console.php:23 命令类注册 CLI 名称与业务入口相符。
server/sql/1.9.20260507/add_sync_im_chat_archive_crontab.sql:14、:17 注册 sync_im_chat_archive,周期 */30 * * * * 数据库内置调度与系统每分钟调度器是两层。
server/sql/1.9.20260909/fix_im_chat_archive_crontab.sql:3–:8 已有任务改为 --since-days=0 --limit=200 调整覆盖范围不会解决文件权限;不要为本故障重复插入任务。
docs/plans/prescription-ai-deployment.md:19、:20、:28 既有部署记录为 /www/wwwroot/zyt/server、/www/server/php/82/bin/php、运行用户 www,曾验证 www 的 runtime 写权限 可作为现场核对起点;历史记录不能代替当前进程/权限检查。
docs/plans/assistant-revisit-reach-deployment.md:53、:60–:67 文档要求执行 php think clear、初始化命令和每分钟 php think crontab,没有在每条命令明确运行用户 运维按 root 终端照抄存在身份混用风险;后续说明宜明确 www。
server/docs/qywx-im-deploy.md:53–:64 另一组系统 cron 示例直接执行 php think,未写用户 同项目其他 cron 也需要核查身份,否则依然可能污染共享缓存。
docs/wecom-promotion-automation-deployment.md:30–:34 Supervisor 示例使用 user=www-data 是通用示例,线上为 www 时应使用现场身份;避免用户命名混用。
docker/docker-compose.yml:38、:41–:52 PHP 服务 user 被注释;欢迎语 CLI worker 没有显式 user 属本地开发栈隐患;未检查镜像默认用户,不能据此推断线上 root。

线上只读核对命令

以下 Linux 命令仅作为执行建议,本次未执行。路径来自现有部署记录,现场先核对:

APP=/www/wwwroot/zyt/server
readlink -f "$APP"
ps -eo user,group,pid,ppid,comm | awk 'NR == 1 || $5 ~ /php/'
stat -c '%U:%G %a %n' "$APP/runtime" "$APP/runtime/cache" "$APP/runtime/cache/la"
namei -l "$APP/runtime/cache/la"
find "$APP/runtime/cache" -xdev -type d ! -user www -printf '%u:%g %m %p\n' | head -n 40
find "$APP/runtime/cache" -xdev -type f ! -user www -printf '%u:%g %m %p\n' | head -n 40
runuser -u www -- test -w "$APP/runtime/cache/la"
printf 'cache-prefix-write-check=%s\n' "$?"
getfacl -p "$APP/runtime/cache" "$APP/runtime/cache/la"
lsattr -d "$APP/runtime/cache" "$APP/runtime/cache/la"
findmnt -T "$APP/runtime/cache/la"
df -h "$APP/runtime/cache/la"
df -i "$APP/runtime/cache/la"

还应对报错中完整文件及其散列子目录执行 stat / namei -l / getfacl。仅检查 la 顶层可写并不足够:root 所有的子目录不可写会阻止新缓存创建,root 所有的 0644 文件会阻止既有缓存覆盖;祖先目录缺少遍历权限、ACL 或 SELinux 也能产生相同报错。

调度位置定位时仅打印文件名,避免把脚本中可能含有的凭据写入审计输出:

grep -RIlE 'think[[:space:]]+(crontab|sync_im_chat_archive)' /var/spool/cron /etc/cron.d /www/server/cron 2>/dev/null

随后本地核实匹配 cron 的任务归属、宝塔配置中的执行用户,以及包装脚本是否降权。对于启动后常驻的 PHP worker,核查 Supervisor user / systemd User / 容器 UID。PHP-FPM 的 master 为 root 可以正常存在;应以处理请求的 pool worker 身份为准。

若属主与 POSIX 权限均正常,再核查 ACL mask、只读挂载、immutable 标记、SELinux 拒绝日志。磁盘满或 inode 满一般会产生不同错误,但可同时排除。

持久修复建议

  1. 先把会写这个应用缓存的系统调度和常驻进程统一为确认后的应用用户。若 PHP-FPM worker 确认为 www,可让 root/宝塔调度脚本显式 runuser -u www;不要只是给命令外层做目录授权。保留既有执行周期、命令参数、日志和互斥机制,修改现有条目,避免重复注册调度。
  2. 用户切换后,修复已产生的缓存所有权。限制操作到核实后的应用缓存目录,保留缓存内容;不要为此清空聊天归档表或整个 runtime。
  3. 后续部署执行 php think clear、迁移、初始化、预热等 PHP 命令也使用 www;Supervisor、systemd、容器中涉及该应用的 worker 同样明确身份。
  4. 如确实需要多个 OS 用户共享文件缓存,才采用专用组、setgid 目录、默认 ACL 与一致 umask;单一应用用户方案更直接。仅设 setgid 而文件仍为 0644 不能让同组用户覆盖文件。

root / 宝塔包装脚本示例(PHP 路径、项目目录、应用用户确认后使用):

#!/bin/sh
set -eu
cd /www/wwwroot/zyt/server
exec /usr/sbin/runuser -u www -- /www/server/php/82/bin/php think crontab

/etc/cron.d 示例具有独立的用户字段;不要把该行直接放进用户 crontab,二者格式不同:

* * * * * www cd /www/wwwroot/zyt/server && /www/server/php/82/bin/php think crontab

只修复已确认缓存树的命令示例(有变更,需在调度身份修正后执行):

APP=/www/wwwroot/zyt/server
CACHE=$(readlink -f -- "$APP/runtime/cache")
test "$CACHE" = /www/wwwroot/zyt/server/runtime/cache || exit 1
find "$CACHE" -xdev -type d -exec chown www:www {} +
find "$CACHE" -xdev -type f -exec chown www:www {} +
find "$CACHE" -xdev -type d -exec chmod u+rwx {} +
find "$CACHE" -xdev -type f -exec chmod u+rw {} +

该示例不跟随内部符号链接;如发现缓存树中存在符号链接,应先解释其用途和实际目标。仅恢复属主读写,不对整个站点执行 chmod 777。runtime 下可能保存 IAM 事务、私有音频、加密密钥等有意设为 0600 的文件;不要笼统递归 chmod 全部 runtime。

若 runtime/cache 本身不存在,则在确认路径无重定向后以 www 身份创建所需目录;同时保证祖先目录可遍历。若错误路径实际为 runtime/adminapi/cache 等应用子路径,应按现场路径做等价的有限修复。

不建议为了本次事件直接全站改用 Redis:当前配置提供 Redis 选项,但切换会影响所有默认缓存、已有登录状态及正在续拉的 token,另需验证连接、数据语义和所有进程配置一致性。即使改 Redis,其他 runtime 文件仍要求正确的进程身份。

验收标准

  • HTTP 同步至少推进一次 token 续拉,返回同步进度而无 Permission denied;检查点完成后可再次同步。
  • 用 www 执行一个获授权诊单的补拉命令:/www/server/php/82/bin/php think sync_im_chat_archive --diagnosis-id=<已确认ID> --limit=1。该命令会请求腾讯并写业务归档,不是只读探针,避免作为权限调查的第一步。
  • 等待现有系统调度至少完成一轮后,重新检查缓存所有权,确认没有新增 root 属主目录/文件;后台 IM 定时任务错误清除、last_time 正常推进。只在当前数据证明必要时恢复异常停掉的其他任务。
  • 重复检查 Supervisor / systemd / cron / 手工部署 PHP 命令身份;仅手工 chown 后立即点击成功,尚不足以证明不会复发。

本子任务未修改调度、改动业务代码或执行线上验证命令;线上属主证据仅按主线程现场反馈记录。修复和验收结果由主线程补充。