Bitnami Mautic虚拟机调用/api/contacts返回404且清缓存报段错误

基础配置校验 #

• 验证重写规则是否生效：查看Bitnami Mautic的Apache前缀配置文件，执行命令cat /opt/bitnami/apps/mautic/conf/httpd-prefix.conf，确认配置中存在AllowOverride All字段，缺失则新增后执行sudo /opt/bitnami/ctlscript.sh restart apache重启Web服务。
• 注意：Mautic 3.x/4.x 版本默认API路径前缀为/s，未配置根目录映射时请求地址应为http://<虚拟机IP>/s/api/contacts，直接请求/api/contacts会直接返回404，优先按该规则调整请求地址测试
• 校验PHP版本匹配度：Mautic 3.3.x要求PHP版本为7.3/7.4，Mautic 4.0.x要求PHP版本为7.4/8.0，执行php -v确认CLI端PHP版本与Web服务使用的PHP版本一致，版本不匹配是缓存清理时出现段错误的常见诱因。

段错误场景缓存清理替代方案 #

官方提供的cache:clear命令触发段错误时，直接手动操作缓存目录即可，无需依赖控制台命令：

• 执行命令删除所有旧缓存文件：sudo rm -rf /opt/bitnami/apps/mautic/htdocs/var/cache/*
• 给缓存目录授予正确权限：sudo chown -R daemon:daemon /opt/bitnami/apps/mautic/htdocs/var/cache
• 缓存预热：切换到Web服务用户执行预热命令sudo -u daemon php /opt/bitnami/apps/mautic/htdocs/bin/console cache:warmup --env=prod，如果命令仍然返回段错误，直接访问Mautic后台首页，系统会自动生成可用的新缓存文件。

API 404 问题二次验证 #

缓存重建完成后按以下顺序验证：

• 登录Mautic后台进入【配置】-【API设置】，确认API启用状态、CORS规则匹配你的请求端IP/域名
• 携带正确的OAuth2认证头请求http://<虚拟机IP>/s/api/contacts，确认返回结果
• 如仍返回404，查看Apache错误日志定位具体原因，执行命令tail -n 50 /opt/bitnami/apache2/logs/error_log，排查是否存在重写规则、权限或PHP执行类报错。

兜底兼容方案 #

• 确认VirtualBox给虚拟机分配的运行内存≥2G，内存不足会导致PHP进程执行时触发段错误
• 如预制OVA镜像始终存在异常，可改用Bitnami LAMP基础镜像手动部署对应版本Mautic，避免预制镜像的隐藏配置冲突。

内容的提问来源于stack exchange，提问作者PirateApp