Zo los je INVALID_EMAIL_ADDRESS op in Salesforce-deployments

Een record dat wordt opgeslagen heeft een waarde in een e-mailveld die niet voldoet aan de e-mailformaatvalidatie van Salesforce.

Verschijnt tijdens: DML tijdens runtime, meestal Apex test setup of een data load

Wat het betekent

INVALID_EMAIL_ADDRESS betekent dat een veld dat als Email-type is gemarkeerd op het object een waarde kreeg die de ingebouwde formaatcontrole van Salesforce afwijst, doordat een @-teken ontbreekt, de domeinvorm ongeldig is, of er ongewenste spaties in staan. Salesforce valideert e-mailvelden op platformniveau, ongeacht eventuele custom validatieregels, dus dit treedt zelfs op bij objecten zonder eigen e-mailspecifieke automatisering.

De ingebouwde controle van Salesforce is bewust soepel in wat als een geldig domein telt, dus de meeste echte adressen komen erdoor; de waarden die falen zijn bijna altijd synthetische testdata of placeholder-data in plaats van echte typefouten in echte klant-e-mails.

Diagnose

Veelvoorkomende oorzaken

Test- of seed-data gebruikt een misvormd adres

Fixture-data bevat een placeholder-waarde die nooit een geldige e-mailvorm had, zoals een kale gebruikersnaam of een domein zonder punt.

Migratie koppelde de verkeerde bronkolom

Een veldmapping in het ETL- of data load-script wijst een niet-gerelateerde tekstkolom naar het Email-veld in plaats van de daadwerkelijke e-mailbron.

Een locale-specifieke of interne placeholder glipte erdoorheen

Een interne markeringswaarde, zoals "n/a" of een systeemdefault, werd geladen in een verplicht Email-veld in plaats van leeg te blijven.

De oplossing

Corrigeer de probleemwaarde bij de bron
Corrigeer het misvormde adres in de testfixture of brondata in plaats van een workaround voor de veldvalidatie te bedenken.
Gebruik correct gevormde adressen in fixtures
Standaardiseer op een patroon zoals [email protected] voor gegenereerde testdata, zodat het altijd de e-mailvalidatie doorstaat.
```
String testEmail = 'test-user+' + String.valueOf(Math.abs(Crypto.getRandomInteger())) + '@example.com';
```
Controleer de veldmapping van de migratie
Bevestig dat de bronkolom die het Email-veld voedt daadwerkelijk e-mailadressen bevat voordat de volgende load draait.

In de praktijk

Hoe Serpent dit voorkomt

Omdat Serpent de volledige testsuite, inclusief alle data setup, bij elke taak vóór de merge uitvoert, komt een misvormde e-mail in testfixtures aan het licht op de branch die deze introduceerde, in plaats van later een productierelease te blokkeren. Bekijk de bibliotheek met Salesforce-deploymentfouten.

Metadata en data in één deploymentflow in Serpent

Preventie

Centraliseer het genereren van testmails in één gedeelde factory-methode

Laat elke testklasse via één gedeelde utility lopen die gegarandeerd geldige, unieke e-mailadressen produceert, in plaats van elke test zijn eigen adres te laten schrijven.

Valideer e-mailkolommen vóór een migratie, niet nadat deze mislukt

Voer een lichtgewicht regex-controle uit op de bronkolom die aan Email is gekoppeld, als onderdeel van de data-profilering voorafgaand aan de migratie.

Laad nooit sentinel-waarden in een echt Email-typeveld

Gebruik een null-waarde of een apart vlagveld voor "unknown" of "niet van toepassing" in plaats van een placeholder-string in een Email-veld te schrijven.

Gerelateerde fouten

STRING_TOO_LONGNog een formaatbeperking op veldniveau die door het platform wordt afgedwongen, ongeacht validatieregels.FIELD_CUSTOM_VALIDATION_EXCEPTIONDe tegenhanger met custom regels van deze formaatcontrole op platformniveau.

Veelgestelde vragen

INVALID_EMAIL_ADDRESS, uitgelegd

Kan ik e-mailvalidatie omzeilen voor een specifiek record?

Nee. Salesforce handhaaft de e-mailformaatcontrole op Email-typevelden ongeacht validatieregels of trigger-instellingen; de waarde zelf moet een geldige vorm hebben.

Geldt dit voor een Text-veld met een e-mailachtige waarde, of alleen voor echte Email-velden?

Alleen echte Email-typevelden triggeren deze controle op platformniveau. Een Text-veld met een e-mailachtige string wordt niet gevalideerd, tenzij een aparte validatieregel dit afdwingt.

Veroorzaakt een leeg Email-veld ooit deze fout?

Nee, tenzij het veld ook als verplicht is gemarkeerd; in dat geval is de fout REQUIRED_FIELD_MISSING in plaats van INVALID_EMAIL_ADDRESS. Een leeg optioneel Email-veld wordt altijd geaccepteerd.

Start gratis. Geen creditcard, geen installatie, geen verplichting.

Binnen 15 minuten ingesteld. Geen DevOps-aanwerving nodig.

Start gratis Boek een demo