从Docker到宝塔：Magento2 2.3.5 安装全流程踩坑与成功实践

前言：Magento2 作为 Adobe 旗下的企业级开源电商平台，凭借强大的扩展性、多语言支持和精细化运营功能，成为全球众多电商企业的首选。但它的安装配置门槛较高，尤其对新手而言，环境兼容、依赖管理、静态资源部署等环节极易踩坑——我就曾因盲目尝试 Docker 容器部署，遭遇了版本冲突、权限隔离、内存溢出等一系列问题，耗费大量时间仍未成功。后来转向操作更直观的宝塔面板，在反复调试中解决了 Composer 1.x 降级、内存限制解除、静态文件 404、CSS/JS 缺失等核心痛点，最终摸索出一套完整且可复现的安装流程。本文将全程还原从 Docker 碰壁到宝塔成功部署的全过程，不仅包含环境配置、依赖安装、网页向导等基础步骤，还针对“静态资源缺失”“Composer 版本冲突”等高频报错提供了与实际操作完全对应的解决方案。无论你是初次接触 Magento2 的新手，还是曾被安装问题卡壳的开发者，都能通过本文避开坑点，高效完成 Magento2 2.3.5 的部署与配置。

一、Magento2 是什么？它能做什么？

Magento2 是 Adobe 旗下的企业级开源电商平台，以强大的可扩展性、灵活性和丰富的功能模块著称。无论是搭建 B2C 零售商城、B2B 批发平台，还是定制化电商解决方案，Magento2 都能满足需求。

其核心功能包括：

多语言/多货币支持：适配全球市场，轻松切换语言和货币单位。
扩展生态丰富：官方及第三方提供数万款插件，覆盖营销、物流、支付、数据分析等场景。
精细化订单管理：从订单创建、支付、发货到售后，全流程可视化管控。
SEO 友好性：内置 SEO 工具，助力电商网站获取更好搜索引擎排名。
自定义主题系统：支持个性化界面设计，打造独特品牌电商体验。
高性能架构：支持缓存优化、数据库读写分离，应对高并发访问场景。

二、Docker 部署的“碰壁”经历

起初尝试通过 Docker 容器镜像 部署 Magento2，本以为能简化环境配置，却遭遇一系列问题：

依赖版本冲突：容器内 PHP 扩展（如 intl、soap）与 Magento2 2.3.5 兼容性差，调试成本极高。
网络与权限隔离：容器端口映射频繁失效，静态资源部署时因权限隔离无法正常读写文件。
内存溢出频发：Composer 依赖安装时频繁触发内存溢出，即使调整容器内存限制也无济于事。

几番尝试后，决定改用 宝塔面板 安装——其可视化界面能快速配置 PHP 环境、权限和数据库，更适配 Magento2 这类复杂系统的安装需求。

三、宝塔面板安装 Magento2 2.3.5 完整流程

步骤 1：宝塔面板与基础环境安装

安装宝塔面板（以 CentOS 为例）：

1yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh
2

安装完成后，根据终端提示的“面板地址+账号密码”登录宝塔。

安装核心环境：
进入宝塔面板「软件商店」，安装：

PHP 7.3（Magento2 2.3.5 唯一兼容的稳定版本）
MySQL 5.7（避免高版本数据库兼容性问题）
Nginx 1.20+（或 Apache，本文以 Nginx 为例）

步骤 2：PHP 7.3 环境配置

安装必需扩展：
进入宝塔「PHP 管理」→ 选择「PHP 7.3」→「扩展」，安装：
bcmath、curl、gd、intl、mbstring、mysqli、openssl、pdo_mysql、simplexml、soap、xsl、zip
调整内存限制：
点击「配置文件」，将 memory_limit = 128M 改为 memory_limit = 2G，保存后重启 PHP 7.3。

步骤 3：创建网站与数据库

创建网站：
宝塔面板「网站」→「添加站点」，填写域名（无域名填服务器 IP），设置根目录为 /www/wwwroot/magento2-2.3.5。
创建数据库：
进入宝塔「数据库」→「添加数据库」，填写数据库名、用户名、密码（务必记录，后续安装需用到）。

步骤 4：上传并解压安装包

从 Magento 官网下载 Magento2 2.3.5 压缩包，通过宝塔「文件」功能上传至网站根目录 /www/wwwroot/magento2-2.3.5 并解压。

在这里插入图片描述

步骤 5：进入项目根目录并配置 Composer（期间如果输出出现乱码就是有问题）

1cd /www/wwwroot/magento2-2.3.5
2

降级 Composer 到 1.x 版本（Magento2 2.3.5 仅兼容 Composer 1.x）：

1composer self-update --1
2

验证版本：composer -V（需显示 1.x 版本，如 Composer version 1.10.26）。

临时解除内存限制，安装核心依赖：

1COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev
2

作用：解决“内存不足导致依赖安装失败”的报错，--no-dev 表示仅安装生产环境依赖。

更新依赖确保兼容性：

1composer update
2

步骤 6：文件权限修复

1chown -R www:www /www/wwwroot/magento2-2.3.5
2chmod -R 775 var pub generated app/etc
3

步骤 7：网页端安装向导配置（核心流程）

浏览器访问 http://你的服务器IP/setup，按以下流程操作：

7.1 协议与环境检测

同意服务协议，进入「准备情况检查」，确保所有项为绿色（若 PHP 扩展缺失，返回步骤 2 补充安装）。

7.2 数据库配置

填写步骤 3创建的数据库信息：
- 数据库名：（如 magento2_db）
- 用户名/密码：数据库账号密码
- 主机：localhost

7.3 网站基础配置

商店地址：http://你的服务器IP
管理员路径：admin（可自定义，如 magentoadmin）
取消勾选「使用 Apache 重写」（Nginx 环境无需启用）。

7.4 商店参数设置

时区：China Standard Time
货币：人民币(CNY) 或 美元(USD)
语言：Chinese (simplified Han, China)

7.5 创建管理员账号

填写用户名、邮箱、密码（需包含大小写字母+数字+特殊字符），牢记账号密码。

7.6 完成安装

点击「安装」，等待 5-10 分钟（视服务器配置而定），安装完成后显示「Success」提示。

步骤 8：启动内置服务器（开发环境专用）

1如果只有一个版本的php的话，就不用写全路径
2

1cd /www/wwwroot/magento2-2.3.5/pub
2

用 PHP 7.3 全路径启动服务器（指定本地 IP）：

1/www/server/php/73/bin/php -S 192.168.0.116:8000
2

说明：192.168.0.116 替换为服务器内网 IP；若需外网访问，改为 0.0.0.0:8000。

四、问题处理：缺少CSS/JS静态文件的解决方案

在这里插入图片描述

若安装后出现前端样式错乱（如页面无CSS、JS加载失败），按以下步骤处理（与图片操作完全对应）：

执行SQL关闭静态文件签名：
登录宝塔「数据库」→ 选择 Magento 数据库 → 点击「phpMyAdmin」，执行以下SQL语句：

1INSERT INTO `core_config_data` (`config_id`, `scope`, `scope_id`, `path`, `value`) VALUES (NULL, 'default', '0', 'dev/static/sign', '0');
2

清理Magento缓存：

1cd /www/wwwroot/magento2-2.3.5
2/www/server/php/73/bin/php bin/magento cache:clean
3/www/server/php/73/bin/php bin/magento cache:flush
4

部署中英文静态资源：

1# 英文静态文件
2/www/server/php/73/bin/php bin/magento setup:static-content:deploy -f
3
4# 中文静态文件
5/www/server/php/73/bin/php bin/magento setup:static-content:deploy zh_Hans_CN -f
6
7# 同时部署英文+中文（可选）
8/www/server/php/73/bin/php bin/magento setup:static-content:deploy en_US zh_Hans_CN -f
9

重启Web服务：
先杀死旧的PHP内置服务器进程，再重新启动：

1ps aux | grep "/www/server/php/73/bin/php -S" | grep -v grep | awk '{print $2}' | xargs -r kill -9
2cd /www/wwwroot/magento2-2.3.5/pub
3/www/server/php/73/bin/php -S 192.168.0.116:8000
4

以下是补充到文章“4. 重启Web服务”部分的内容，已调整IP为通用表述并优化步骤可读性：

五. 如果页面一直无限转圈-可选步骤

在这里插入图片描述

若界面加载异常或持续转圈，按以下步骤重启服务（将你的服务器IP替换为实际服务器公网/内网IP）：

杀死旧的PHP 7.3内置服务器进程（避免端口冲突）

1ps aux | grep "/www/server/php/73/bin/php -S" | grep -v grep | awk '{print $2}' | xargs -r kill -9
2

1cd /www/wwwroot/magento2-2.3.5
2

用PHP 7.3全路径清理缓存

1/www/server/php/73/bin/php bin/magento cache:flush
2

删除缓存文件和生成文件（彻底清理）

1rm -rf var/cache/* var/page_cache/* generated/*
2

同时部署英文+中文静态资源（PHP 7.3全路径执行）

1/www/server/php/73/bin/php bin/magento setup:static-content:deploy en_US zh_Hans_CN -f
2

1chmod -R 775 var pub generated
2

修复文件归属（适配宝塔www用户）

1chown -R www:www /www/wwwroot/magento2-2.3.5
2

进入pub目录（Magento官方访问入口）

1cd pub
2

用PHP 7.3全路径启动服务器（后台运行，日志单独记录）

1nohup /www/server/php/73/bin/php -S 0.0.0.0:8000 > ../magento_73.log 2>&1 &
2

执行完所有步骤后，访问 http://你的服务器IP:8000/admin 即可。若仍有问题，可查看日志排查：

1tail -30 /www/wwwroot/magento2-2.3.5/magento_73.log
2

在这里插入图片描述

六、关键问题与解决方案

静态文件部署报错：必须先执行 COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev 解除内存限制。
Composer 版本冲突：Magento2 2.3.5 仅兼容 Composer 1.x，需用 composer self-update --1 降级。
静态资源 404/样式错乱：按“问题处理”章节的SQL+缓存+静态部署+重启流程操作。
服务器启动后无法访问：执行 kill -9 $(lsof -t -i:8000) 释放端口后重新启动。
后台登录后操作无响应：执行 /www/server/php/73/bin/php bin/magento cache:clean 清理缓存，同时检查 var/session 目录权限（需设置为 775 且归属 www 用户）。

七、总结

从 Docker 到宝塔的部署尝试，验证了工具选择需适配系统复杂度的原则。宝塔面板的可视化操作简化了 PHP 环境、权限、数据库的配置流程，尤其适合 Magento2 这类复杂电商系统的新手安装。

核心步骤总结：

环境：PHP 7.3 + MySQL 5.7 + Nginx + Composer 1.x。
流程：先创建数据库，再通过网页向导配置，最后处理静态资源问题。
问题：静态资源缺失需关闭 URL 签名、重新部署静态文件，属于报错时的标准修复流程。

希望这篇全流程指南能帮你避开安装坑，顺利开启 Magento2 电商之旅！
在这里插入图片描述

《从Docker到宝塔：Magento2 2.3.5 安装全流程踩坑与成功实践》是转载文章，点击查看原文。