Mi experiencia con el error de pasar de entrada no controlada a controlada

Guía para evitar la advertencia Changing from Uncontrolled input to Controlled en React: define value desde el inicio, usa defaultValue o String() y buenas prácticas con register y Controller para formularios robustos.

17 ago 2025 • 2 min read • Q2BSTUDIO Team

Inteligencia-Artificial-

Mi experiencia personal con el error Changing from Uncontrolled input to Controlled

Cuando empecé a construir formularios en mi proyecto actual apareció este mensaje en la consola: A component is changing an uncontrolled input to be controlled. Esto se mostraba como una bandera roja cada vez que cargaba el formulario y fue la pista para encontrar un pequeño pero importante fallo de diseño.

La causa raíz

Un input no controlado pasa a ser controlado si su prop value cambia de undefined a un valor definido después del primer render.

Ejemplo del problema: <input value={formData.name} onChange={handleChange} />

Si formData.name es undefined al principio, React trata el input como no controlado. Cuando los datos se cargan y formData.name pasa a tener un valor como User, React detecta que el input ha cambiado de no controlado a controlado y lanza la advertencia.

Cómo lo solucioné

Me aseguré de que el value siempre estuviera definido incluso antes de que los datos terminaran de cargar. Por ejemplo: <input value={formData.name ?? String()} onChange={handleChange} />

Cuando uso React Hook Form es importante proporcionar defaultValue explícito para evitar este cambio de estado: <input {...register(fieldName)} defaultValue={String()} />

Para componentes controlados envueltos con Controller conviene inicializar defaultValue también: <Controller name={fieldName} control={control} defaultValue={String()} render={({ field }) => <InputText {...field} /> />

Lección aprendida

Decidir desde el principio si un input será controlado o no es clave. Si optas por controlado, inicializa value con una cadena vacía o con un valor por defecto razonable usando expresiones como String() en JSX para evitar undefined. Si optas por no controlado, evita bindear value y usa defaultValue o refs.

Cómo esto encaja con nuestro trabajo en Q2BSTUDIO

En Q2BSTUDIO, empresa de desarrollo de software y aplicaciones a medida, aplicamos estas buenas prácticas en cada proyecto. Somos especialistas en inteligencia artificial ciberseguridad y servicios cloud aws y azure y desarrollamos soluciones de software a medida que incluyen formularios robustos y manejos de estado previsibles. También ofrecemos servicios de inteligencia de negocio implementaciones de power bi y agentes IA para integrar inteligencia artificial e IA para empresas en procesos productivos.

Evitar errores como el cambio de input no controlado a controlado ahorra tiempo de debugging y mejora la calidad del producto. En Q2BSTUDIO combinamos experiencia técnica en desarrollo de aplicaciones a medida con conocimientos en seguridad y servicios cloud para entregar soluciones escalables y seguras.

Si necesitas soporte en software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio o implementar agentes IA y power bi para tu empresa, en Q2BSTUDIO podemos ayudarte a diseñar formularios y componentes React siguiendo las mejores prácticas para evitar errores y optimizar la experiencia de usuario.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.