TYPO3 10.4.1中Extension Builder新建扩展未生成数据库表的排查咨询

• 首先确认扩展的实际激活与加载状态
  Composer流程仅完成包文件的拉取与自动加载注册，不会自动将扩展标记为TYPO3可用状态。首先登录TYPO3后台进入「扩展管理」模块，搜索你开发的自定义扩展，查看是否处于未激活状态——未激活的扩展内所有初始化逻辑（包括ext_tables.sql解析、TCA配置加载）都不会被核心执行，自然不会触发建表流程。
  如果是本地路径加载的自定义开发扩展，需要额外检查composer.json内的repositories配置：确认是否为扩展配置了path类型的仓库指向，避免composer误拉取了同命名的空占位包，而非你本地开发的扩展版本。
• 核查核心数据库同步的默认规则
  TYPO3 10.4的数据库结构同步，默认是不会自动创建新数据表的——核心内置的数据库分析工具，默认仅对已存在的表做字段结构调整，新表创建操作需要手动触发。你可以进入后台的「数据库分析」模块，找到待创建的自定义表条目，手动勾选执行建表操作；也可以通过命令行手动触发同步，执行命令：
  php vendor/bin/typo3 database:updateschema
  注意如果命令行执行后无对应表生成，需要检查命令执行的用户是否和站点运行的PHP用户一致，避免权限差异导致的配置读取偏差。
• 检查扩展内的数据库定义文件合规性
  确认扩展根目录下是否存在ext_tables.sql文件：Extension Builder如果保存路径配置异常，很容易将sql文件输出到扩展的Resources等子目录下，核心扫描时仅会读取扩展根目录下的该文件，子目录的文件会被完全忽略。
  同时打开扩展根目录下的ext_emconf.php文件，确认没有设置$EM_CONF['你的扩展key']['skipDatabaseSchemaUpdate'] = true的配置，该配置会让核心完全跳过对该扩展的数据库结构解析。
  另外检查表命名是否符合TYPO3的安全规则：自定义表默认需要使用tx_你的扩展标识_作为前缀，如果表名和核心系统表重名，核心会直接跳过该表的创建流程，避免误修改系统表结构。
• 验证数据库账号权限边界
  Ubuntu下的MariaDB默认对站点使用的数据库账号做了权限收缩，很多场景下账号仅拥有已存在表的增删改查权限，没有CREATE TABLE的权限。这种情况下建表操作会被数据库侧直接拒绝，但TYPO3核心为了不中断站点运行，会静默跳过失败步骤，不会在composer流程或者前端弹出明确报错。可以手动用站点的数据库配置登录MariaDB，执行一次测试建表语句确认权限是否充足。
• 通过日志定位静默失败原因
  直接查看站点运行目录下var/log/路径内的TYPO3运行日志，搜索和ext_tables.sql、你扩展标识相关的日志条目。常见的静默失败原因包括：sql语法和当前MariaDB版本不兼容、字段长度超出数据库默认配置的上限、定义的字段类型不被当前数据库支持，这类问题核心都会直接跳过对应sql段执行，不会给出前端提示。

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