Question 1

为什么 Docker 首次运行脚本会出现“Your lock file does not contain a compatible set of packages”错误？

Accepted Answer

此错误是由于 Docker 容器中的 PHP 版本（PHP 7.4）与包要求（需要 PHP 8.1 或更高版本）不匹配，再加上过时的锁文件约束共同导致。修复方法：1) 将 Dockerfile 基础镜像更新为 PHP 8.1+ 版本（例如 php:8.1-fpm）并重新构建容器。2) 启动容器后，运行 'composer update --with-all-dependencies' 以解决冲突的包版本（例如 specshaper/encrypt-bundle 与 doctrine/orm 之间的冲突）。如果仍有问题，请手动编辑 composer.json，允许 doctrine/common 或其他冲突包的兼容版本。这些步骤可使环境与当前依赖需求保持一致。请注意，项目 v2.0 版本简化了自托管流程，可避免这些旧版冲突。

Question 2

当应用程序缺少CSRF令牌时，如何修复CSRF漏洞？

Accepted Answer

添加与用户会话绑定的不可预测的CSRF令牌。在所有状态变更请求（表单、AJAX）中包含该令牌。在处理任何操作之前，严格在服务端验证令牌。使用现有框架库（例如Spring Security、Django CSRF）或手动实现：在登录时生成高熵令牌，存储在会话中，嵌入表单作为隐藏字段，并在提交时验证。

Question 3

如何修复个人管理系统中日历日程保存后恢复为 UTC 的问题？

Accepted Answer

这是一个已确认的前端 bug，而非后端或容器配置问题。虽然日历在创建日程时能正确显示本地时间，但 `TuiCalendarService.ts` 中存在缺陷的时区逻辑导致前端在保存后向后端发送 UTC 格式的日期数据。调整 php-fpm 容器的 `TZ` 环境变量或挂载 localtime 卷无法解决此问题。
临时解决方法：创建日程时手动加上本地时区的 UTC 偏移量（例如 Europe/Berlin 时区需加 2 小时）。
对于源代码部署：更新 `TuiCalendarService.ts` 中的时区处理逻辑，然后运行 `npm run build` 重新构建前端。该 bug 已在官方前端重写版本中修复，但重写版本的完整稳定版发布仍需数月时间。

Question 4

如何修复 Personal Management System 中的 mailpit Docker 构建失败和 PHP autoload 文件缺失问题？

Accepted Answer

使用预构建的 Mailpit 镜像，而不是在本地构建。将 `docker-compose.yml` 中的 `pms-mail` 服务配置替换为：

```yaml
pms-mail:
  container_name: pms-mail
  hostname: pms-mail
  image: axllent/mailpit:latest
  restart: always
  tty: true
  ports:
    - "8082:8025"
    - "1025:1025"
  volumes:
    - pms-mailpit-db:/data
```

然后启动该服务：

```bash
docker compose up -d pms-mail
```

如果 nginx/PHP 报告缺少 autoload 文件，请在 php-fpm 容器内重新生成 Composer 的 autoloader：

```bash
docker exec -it <php-fpm_container_name_or_id> sh
composer dump-autoload
exit
```

最后重启整个服务栈：

```bash
docker compose restart
```

据报告，此变通方法适用于 Ubuntu 20.04 和 24.04 上的全新安装。

Personal Management System

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐