EllanJiang/GameFramework · error · GameFrameworkException

Target ' ' is invalid.

Error message

Target '{0}' is invalid.

What it means

ObjectBase.Initialize is the shared setup for pooled objects and requires a non-null Target — the actual game resource (e.g. an asset, entity, or GameObject) the wrapper represents. A null target makes the pool entry unusable, so it throws with the object's name in the message. Subclass constructors funnel through Initialize, so the throw surfaces when constructing any invalid ObjectBase.

Solutions

1. Ensure the target object is loaded and non-null before constructing/wrapping it
2. Null-check the load result and handle the load failure separately instead of passing null to the object pool
3. Verify resource paths and that the asset exists in the build

Example fix

// before
var obj = new MyObject("enemy", loadedAsset, false, 0); // loadedAsset is null
// after
if (loadedAsset == null) { throw new InvalidOperationException("Failed to load asset 'enemy'."); }
var obj = new MyObject("enemy", loadedAsset, false, 0);

if (target == null) { Log.Error("Cannot pool '{0}': target is null (load failed?)", name); return; }
var obj = new MyObject(name, target, locked, priority);

bool IsValidTarget(object t) => t != null;

try { var obj = new MyObject(name, target, locked, priority); }
catch (GameFrameworkException ex) { Log.Error("Invalid pooled object target: {0}", ex.Message); }

When it happens

Trigger: Constructing an ObjectBase subclass (e.g. FooObject : ObjectBase) with null passed as target, commonly when a resource load returned null before being wrapped.

Common situations: AssetBundle/Resources.Load returning null (missing asset, wrong path) and the result being wrapped unconditionally; async load completing with a null handle result; passing an uninitialized field as target.

Related errors

• Object is invalid.
• Object is invalid.
• Release object filter callback is invalid.
• Results is invalid.
• Object type is invalid.

AI-assisted analysis of EllanJiang/GameFramework@d0c010b051 (2026-09-15). Data as JSON: /api/errors/a99bdeebc323fdd2. Report an issue: GitHub.

Appendix: source

Thrown at GameFramework/ObjectPool/ObjectBase.cs:165

        /// <param name="target">对象。</param>
        /// <param name="priority">对象的优先级。</param>
        protected void Initialize(string name, object target, int priority)
        {
            Initialize(name, target, false, priority);
        }

        /// <summary>
        /// 初始化对象基类。
        /// </summary>
        /// <param name="name">对象名称。</param>
        /// <param name="target">对象。</param>
        /// <param name="locked">对象是否被加锁。</param>
        /// <param name="priority">对象的优先级。</param>
        protected void Initialize(string name, object target, bool locked, int priority)
        {
            if (target == null)
            {
                throw new GameFrameworkException(Utility.Text.Format("Target '{0}' is invalid.", name));
            }

            m_Name = name ?? string.Empty;
            m_Target = target;
            m_Locked = locked;
            m_Priority = priority;
            m_LastUseTime = DateTime.UtcNow;
        }

        /// <summary>
        /// 清理对象基类。
        /// </summary>
        public virtual void Clear()
        {
            m_Name = null;
            m_Target = null;
            m_Locked = false;
            m_Priority = 0;

View on GitHub (pinned to d0c010b051)