PrestaShop后台页面需重复登录及开发面板不显示问题求助

我之前在K8s上部署PrestaShop的时候也碰到过几乎一模一样的问题，给你整理几个针对性的排查和修复步骤：

这个问题是导致后续JS报错的根源——因为会话丢失，PrestaShop的前端模块（比如gamification）拿不到会话中的用户数据，才会抛出Cannot read property 'advices_to_display' of null这类错误。

在Kubernetes集群里，最常见的原因是会话未共享：

• 默认PHP会话存在Pod本地的/var/lib/php/sessions目录，而K8s的Pod是独立的，当请求被负载均衡到不同Pod时，新Pod没有之前的会话数据，就会强制重新生成PHPSESSID，要求用户重新登录。

修复方案：

1. 配置分布式会话存储（推荐）
   用Redis或Memcached统一存储会话，让所有Pod共享会话数据：

   • 先在K8s集群部署Redis服务（比如用Helm安装bitnami/redis）
   • 修改Pod的PHP配置（php.ini）：

     session.save_handler = redis
     session.save_path = "tcp://redis-service:6379"  # 替换成你的Redis服务名和端口
     

   • 确保PHP安装了redis扩展（可以在Pod里执行apt-get install php-redis或者在Docker镜像里预先安装）

2. 临时开启会话亲和（快速缓解）
   如果暂时不想部署Redis，可以修改Ingress配置，让同一用户的请求始终落到同一个Pod：
   在Ingress的annotations里添加：

   nginx.ingress.kubernetes.io/affinity: "cookie"
   nginx.ingress.kubernetes.io/session-cookie-name: "route"
   nginx.ingress.kubernetes.io/session-cookie-expires: "172800"
   nginx.ingress.kubernetes.io/session-cookie-max-age: "172800"
   

3. 检查Cookie配置
   登录PrestaShop后台（如果能暂时登录），进入高级参数 > 性能：

   • Cookie域名：设置为你的生产域名（比如yourshop.com），不要留空或用IP
   • Cookie路径：设置为/
   • Cookie安全：如果你的站点用HTTPS，勾选开启；HTTP则关闭

当会话问题解决后，大部分JS报错会自动消失，再做以下检查：

1. 确认开发模式已开启
   进入Pod的config/defines.inc.php文件，确保以下配置：

   define('_PS_MODE_DEV_', true);
   

   如果是用Docker部署，要确保这个配置在镜像构建时就设置正确，或者通过环境变量覆盖。

2. 清除PrestaShop缓存

   • 后台操作：进入高级参数 > 性能，点击“清除缓存”按钮
   • 手动清除：在Pod里执行命令：

     rm -rf /var/www/html/var/cache/*
     chown -R www-data:www-data /var/www/html/var/cache
     

   缓存过期或损坏也会导致前端模块加载异常。

3. 处理Google Maps API警告
   进入后台模块 > 模块管理器，找到ps_googlemaps模块：

   • 点击“配置”，填入你的Google Maps API密钥（需要在Google Cloud控制台申请并启用Maps JavaScript API）
   • 如果不需要地图功能，直接禁用该模块即可消除警告

• 确认PHP必需模块已启用：执行php -m检查是否包含session、json、curl、mbstring、gd这些模块，缺失的话要安装
• 检查Apache的日志：在Pod里查看/var/log/apache2/error.log，看是否有会话存储相关的权限错误（比如www-data用户无法写入会话目录）

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