将正常运行的Magento线上站点部署至本地时遇数据库表不存在错误

这种表找不到的坑我踩过好多次了，虽然你说本地和线上数据库完全一致，但大概率是数据库连接配置有误或者Magento的缓存在搞怪，咱们一步步排查：

• 先确认数据库连接的核心配置
  别只盯着base_url，app/etc/local.xml里的数据库连接信息才是关键！检查<connection>节点下的内容：

  <connection>
      <host><![CDATA[localhost]]></host>
      <username><![CDATA[你的数据库用户名]]></username>
      <password><![CDATA[你的数据库密码]]></password>
      <dbname><![CDATA[你导入的数据库名称]]></dbname>
      <initStatements><![CDATA[SET NAMES utf8]]></initStatements>
      <model><![CDATA[mysql4]]></model>
      <type><![CDATA[pdo_mysql]]></type>
      <pdoType><![CDATA[]]></pdoType>
      <active>1</active>
  </connection>
  

  重点确认：

  • dbname和你导入的数据库名称完全匹配（Linux环境下数据库名区分大小写）
  • 用户名、密码和本地数据库的账号一致
  • 如果是远程数据库，host要写对IP，而不是localhost

• 强制清理Magento缓存
  线上项目带过来的缓存文件会和本地环境冲突，直接手动删除这些目录下的所有文件：

  • Magento 1：删除var/cache/、var/session/里的所有内容
  • Magento 2：删除var/cache/、var/page_cache/、generated/里的所有内容
    注意别删文件夹本身，只删里面的文件就行。

• 检查数据库表前缀
  如果线上数据库用了表前缀（比如mage_），那local.xml里必须配置对应的前缀：

  <table_prefix><![CDATA[mage_]]></table_prefix>
  

  要是漏了这个，Magento会去找没有前缀的表，自然提示“表不存在”。

• 验证数据库权限与表存在性
  用phpMyAdmin或者命令行登录本地数据库：

  mysql -u 你的用户名 -p
  

  然后执行：

  USE 你的数据库名称;
  SHOW TABLES;
  

  确认能看到所有线上的表，同时检查当前数据库用户有没有该库的读写权限（比如能不能执行SELECT * FROM core_config_data;）。

• 删除线上编译的文件（针对Magento 1）
  如果是Magento 1的项目，线上可能生成了includes/src/目录下的编译文件，这些文件在本地环境可能不兼容，直接删除includes/src/文件夹，让Magento重新生成适配本地的文件。

内容的提问来源于stack exchange，提问作者S.A.