解决Magento 2自定义实体“未知实体类型”错误：深入剖析与配置指南

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/di.xsd">
    <!-- 实体接口与模型类的偏好 -->
    <preference for="VENDOR\WL\Api\Data\WishlistInterface" type="VENDOR\WL\Model\Wishlist" />
    <!-- 仓库接口与仓库实现类的偏好 -->
    <preference for="VENDOR\WL\Api\WishlistRepositoryInterface" type="VENDOR\WL\Model\WishlistRepository" />

    <!-- ... 其他配置 ... -->
</config>

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/di.xsd">
    <!-- ... 偏好配置 ... -->

    <type name="VENDOR\WL\Model\WishlistRepository">
        <arguments>
            <argument name="resource" xsi:type="object">VENDOR\WL\Model\ResourceModel\Wishlist</argument>
            <argument name="collectionFactory" xsi:type="object">VENDOR\WL\Model\ResourceModel\Wishlist\CollectionFactory</argument>
            <!-- 以下是Repository中常用的其他依赖，确保它们也已正确配置 -->
            <argument name="dataObjectFactory" xsi:type="object">VENDOR\WL\Api\Data\WishlistInterfaceFactory</argument>
            <argument name="dataObjectProcessor" xsi:type="object">Magento\Framework\Reflection\DataObjectProcessor</argument>
            <argument name="dataObjectHelper" xsi:type="object">Magento\Framework\Api\DataObjectHelper</argument>
            <argument name="extensibleDataObjectConverter" xsi:type="object">Magento\Framework\Api\ExtensibleDataObjectConverter</argument>
        </arguments>
    </type>

    <!-- ... 其他配置 ... -->
</config>

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/di.xsd">
    <!-- ... 偏好配置和Repository依赖配置 ... -->

    <type name="Magento\Framework\EntityManager\MetadataPool">
        <arguments>
            <argument name="metadata" xsi:type="array">
                <item name="VENDOR\WL\Api\Data\WishlistInterface" xsi:type="array">
                    <!-- 实体的主键字段名，必须与db_schema.xml中定义的一致 -->
                    <item name="entity_id_field" xsi:type="string">wishlist_id</item>
                    <!-- 实体对应的数据库表名，必须与db_schema.xml中定义的一致 -->
                    <item name="table" xsi:type="string">vendor_wl_wishlist</item>
                    <!-- 实体对应的Repository接口 -->
                    <item name="repository" xsi:type="string">VENDOR\WL\Api\WishlistRepositoryInterface</item>
                    <!-- 实体标识符字段名，通常与entity_id_field相同 -->
                    <item name="identifier" xsi:type="string">wishlist_id</item>
                    <!-- 实体对应的具体模型类 -->
                    <item name="entity" xsi:type="string">VENDOR\WL\Model\Wishlist</item>
                    <!-- 实体对应的资源模型类 -->
                    <item name="resource" xsi:type="string">VENDOR\WL\Model\ResourceModel\Wishlist</item>
                </item>
            </argument>
        </arguments>
    </type>
</config>

<?php
use Magento\Framework\App\Bootstrap;

// 确保路径正确，通常在Magento根目录下执行
require __DIR__ . '/app/bootstrap.php';

$params = $_SERVER;
$bootstrap = Bootstrap::create(BP, $params);
$objectManager = $bootstrap->getObjectManager();
$state = $objectManager->get(\Magento\Framework\App\State::class);

try {
    // 设置区域代码，通常为'frontend'或'adminhtml'
    $state->setAreaCode('frontend');

    // 获取WishlistFactory和WishlistRepositoryInterface实例
    // 推荐使用接口获取Repository，而不是具体的实现类
    $wishlistFactory = $objectManager->get('VENDOR\WL\Model\WishlistFactory');
    $wishlistRepository = $objectManager->get('VENDOR\WL\Api\WishlistRepositoryInterface');

    // 创建新的Wishlist实体
    $wishlist = $wishlistFactory->create();

    // 设置实体数据，推荐使用setter方法，而非setData()
    $wishlist->setCustomerId(1);
    $wishlist->setWishlistName('Christmas Wishlist');
    $wishlist->setShared(0);
    // 假设 generateSharingCode() 方法在 VENDOR\WL\Model\Wishlist 中定义
    $wishlist->setSharingCode($wishlist->generateSharingCode());

    // 保存Wishlist实体
    $wishlistRepository->save($wishlist);

    echo "Wishlist '{$wishlist->getWishlistName()}' saved successfully with ID: {$wishlist->getId()}\n";

} catch (\Exception $e) {
    echo "Error saving wishlist: " . $e->getMessage() . "\n";
    // 在开发环境中，可以打印完整的堆栈跟踪以帮助调试
    // echo $e->getTraceAsString();
}
?>