Наверное, самая раздражающая вещь в Entity API изложена вот в этом комменте.
The problem is that you must set an empty value that is compatible with the data type of your field. If you do not, you will get an exception raised. Passing NULL or array() when a string is expected will therefore raise an error.
Another thing to keep in mind is that the data you pass will also depend on whether your field is a single value, a multi value field, or a field with multiple properties.
Пишешь себе, пишешь универсальный код с кучей разнородный полей, и вдруг вместо единообразного сброса поля хренак — и вылезает кучка дополнительных ветвлений.
Кстати, в комменте не сказано, но если по страшному стечению обстоятельств сбрасываемое поле помечено как required — это тоже будет неизбежное исключение.
