
Azure Bitnami WordPress 实例启用多站点后出现 “Not Found” 错误,主因是 wp-config.php 配置错误与 .htaccess 规则未生效或不兼容,需修正站点域名、启用重写模块并确保文件权限及路径正确。
azure bitnami wordpress 实例启用多站点后出现 “not found” 错误,主因是 `wp-config.php` 配置错误与 `.htaccess` 规则未生效或不兼容,需修正站点域名、启用重写模块并确保文件权限及路径正确。
在 Azure Bitnami WordPress 环境中启用多站点(Multisite)时,若 wp-admin 访问返回 "Not Found: The requested URL was not found on this server",通常并非单纯路径问题,而是由配置逻辑冲突、服务器重写支持缺失或关键参数设置不当共同导致。以下为系统性排查与修复步骤:
✅ 一、修正 wp-config.php 中的关键配置项
原配置中存在两处严重错误:
-
define('DOMAIN_CURRENT_SITE', 'My Website');—— 此处必须填写实际可解析的完整域名(如https://example.com或example.com),而非占位文本; - 缺少分号
;导致语法错误(首行define('WP_ALLOW_MULTISITE', true)后无分号)。
✅ 正确写法(以主站域名为 example.com 为例):
define('WP_ALLOW_MULTISITE', true);
define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', true); // 若使用子域名模式(如 site1.example.com)
// define('SUBDOMAIN_INSTALL', false); // 若使用子目录模式(如 example.com/site1),请注释上行并启用此行
define('DOMAIN_CURRENT_SITE', 'example.com'); // ⚠️ 必须为真实域名,不含 http:// 或路径
define('PATH_CURRENT_SITE', '/');
define('SITE_ID_CURRENT_SITE', 1);
define('BLOG_ID_CURRENT_SITE', 1);
? 提示:Bitnami 默认使用 Apache,且
wp-config.php位于/opt/bitnami/apps/wordpress/htdocs/。修改后务必重启服务:sudo /opt/bitnami/ctlscript.sh restart apache
✅ 二、确保 .htaccess 正确且被 Apache 加载
Bitnami Apache 默认禁用 .htaccess 覆盖功能(AllowOverride None),导致重写规则完全失效。需手动启用:
- 编辑 Apache 虚拟主机配置:
sudo nano /opt/bitnami/apps/wordpress/conf/httpd-app.conf
- 找到
<directory></directory>区块,将其中的:AllowOverride None
修改为:
AllowOverride All
- 保存后重启 Apache:
sudo /opt/bitnami/ctlscript.sh restart apache
✅ 同时,.htaccess 文件内容应采用 WordPress 官方推荐格式(含 Authorization 兼容处理,适配 6.0+ 版本):
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
# 强制为 /wp-admin 添加尾部斜杠(避免 404)
RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]
# 直接访问静态资源或目录时跳过重写
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# 将多站点请求重写至核心路径
RewriteRule ^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) $2 [L]
RewriteRule ^([_0-9a-zA-Z-]+/)?(.*\.php)$ $2 [L]
RewriteRule . index.php [L]
⚠️ 注意:
- 文件名必须为
.htaccess(非.htaccess.php); - 位于 WordPress 根目录(
/opt/bitnami/apps/wordpress/htdocs/.htaccess); - 确保文件权限为
644,属主为daemon:daemon(Bitnami 默认 Web 用户组)。
✅ 三、其他关键检查项
-
确认
mod_rewrite已启用:运行sudo /opt/bitnami/apache2/bin/httpd -M | grep rewrite,输出应含rewrite_module; - 清除浏览器缓存与 WordPress 对象缓存(如有启用 Redis/Memcached);
-
禁用所有插件临时排查冲突:重命名
/wp-content/plugins为/wp-content/plugins.disabled; -
验证 DNS 与 SSL:若使用子域名模式,确保
*.example.com已正确解析并配置通配符 SSL(Bitnami Let's Encrypt 支持需额外配置)。
完成上述步骤后,访问 https://example.com/wp-admin/(注意末尾斜杠)即可正常进入后台。若仍报错,请检查 Apache 错误日志定位根本原因:
sudo tail -50 /opt/bitnami/apache2/logs/error_log
? 总结:Bitnami 环境下 WordPress 多站点失败,80% 源于
DOMAIN_CURRENT_SITE值错误 +AllowOverride None限制 +.htaccess文件名/位置错误。严格按本教程顺序校验,即可高效恢复管理后台访问。











