迁移至Amazon Lightsail的Bitnami WordPress（PHP8）类找不到错误排查

1. 路径拼写错误是直接诱因 #

你追踪到的路径/opt/bitnami/wordress明显存在拼写错误（少了一个p，正确路径应为wordpress），这会直接导致PHP无法定位到对应的类文件。这类错误通常出现在：

• 主题或插件代码中硬编码了错误的绝对路径
• WordPress配置文件wp-config.php里的路径常量设置有误
• 符号链接的目标路径配置错误

2. 路径/权限问题确实会引发类找不到错误 #

• 路径问题：PHP的类加载（无论是手动require/include还是自动加载机制）完全依赖正确的文件路径。一旦路径错误，或者符号链接导致路径映射混乱，PHP就会找不到类文件，触发Class not found错误。Bitnami WordPress默认安装路径是/opt/bitnami/wordpress，而你当前实际路径是/bitnami/wordpress，如果符号链接的映射逻辑没处理好，会导致PHP解析路径时出现偏差。
• 权限问题：虽然你已经设置了bitnami:daemon用户组，但如果类文件所在目录或文件的权限是600/700，PHP进程（通常以daemon用户运行）会没有读取权限，同样会触发类找不到的错误。不过你本地环境运行正常，权限问题的可能性相对较低，但可以再确认下roof主题目录下的文件权限是否为644、目录权限是否为755。

3. 符号链接部署的额外注意点 #

Bitnami WordPress采用符号链接部署时，需要确保：

• 符号链接使用绝对路径且拼写正确，比如执行ln -s /opt/bitnami/wordpress /bitnami/wordpress（根据实际映射方向调整）
• WordPress的WP_CONTENT_DIR、WP_CONTENT_URL等常量配置正确，避免硬编码路径导致解析错误。可以在wp-config.php里检查并修正：

  define('WP_CONTENT_DIR', '/bitnami/wordpress/wp-content');
  define('WP_CONTENT_URL', 'https://你的域名/wp-content');
  

• 确认PHP的open_basedir限制是否允许访问实际路径。Bitnami可能会设置该限制，需要确保/bitnami/wordpress和/opt/bitnami/wordpress都在允许的路径列表中。

4. 具体排查步骤 #

• 全局搜索主题文件中的错误路径：查找所有包含/opt/bitnami/wordress的代码，替换为正确路径，或改用WordPress内置常量（比如get_template_directory()）来生成路径
• 检查符号链接状态：执行ls -l /bitnami/wordpress，确认目标路径是否正确且存在
• 重置主题权限：执行以下命令确保文件和目录权限符合要求：

  find /bitnami/wordpress/wp-content/themes/roof -type f -exec chmod 644 {} \;
  find /bitnami/wordpress/wp-content/themes/roof -type d -exec chmod 755 {} \;
  

• 开启PHP错误日志：在/opt/bitnami/php/etc/php.ini中设置error_log = /opt/bitnami/apache2/logs/php_error.log，重启Apache后查看详细日志，获取更多路径解析的细节

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