๐Ÿ’ฅ ์†Œํ”„ํŠธ์›จ์–ด ์—”์ง€๋‹ˆ์–ด๋ง์—์„œ ์ž์ฃผ ํ„ฐ์ง€๋Š” 5๊ฐ€์ง€ ํ’‹๊ฑด(Foot-guns) ("5 Software Engineering Foot-guns" ์š”์•ฝ)

okorionยท2025๋…„ 9์›” 23์ผ

๐Ÿ“ Document ์š”์•ฝ ๋ฐ ๋ฒˆ์—ญ

๋ชฉ๋ก ๋ณด๊ธฐ
20/90

โ€œ๋›ฐ์–ด๋‚œ ๊ฐœ๋ฐœ์ž์˜ ๋จธ๋ฆฟ์† ๊ตฌ์„์—๋Š” ํ•ญ์ƒ ์–ด๋ฆฌ์„์Œ์ด ์ˆจ์–ด ์žˆ๋‹ค.โ€
โ€” ์•„๋ฆฌ์Šคํ† ํ…”๋ ˆ์Šค

ํ’‹๊ฑด(foot-gun)์ด๋ž€, ์ž์‹ ์ด ์Šค์Šค๋กœ ๋ฐœ๋“ฑ์„ ์˜๋Š” ๊ฒƒ์ฒ˜๋Ÿผ ์ข‹์•„ ๋ณด์ด์ง€๋งŒ ์žฅ๊ธฐ์ ์œผ๋กœ๋Š” ํ•ด๋กœ์šด ์Šต๊ด€/ํŒจํ„ด์„ ๋งํ•ฉ๋‹ˆ๋‹ค.
Ken(์ „ FiscalNote VP of Engineering, ํ˜„ Truss CTO)์ด 5๋…„๊ฐ„ ๊ฒฝํ—˜ํ•˜๋ฉฐ ๋ผˆ์ €๋ฆฌ๊ฒŒ ๋А๋‚€ 5๊ฐ€์ง€ ๋Œ€ํ‘œ ํ’‹๊ฑด์„ ์†Œ๊ฐœํ•ฉ๋‹ˆ๋‹ค.


1. ๐Ÿคฏ ๋˜‘๋˜‘ํ•œ ์ฝ”๋“œ vs. ๋ช…ํ™•ํ•œ ์ฝ”๋“œ

  • โ€œ์›๋ผ์ด๋„ˆ๋กœ ์ค„์—ฌ๋ณผ๊นŒ?โ€
  • โ€œ์—ฌ๊ธฐ์„œ ์žฌ๊ท€ ์“ฐ๋ฉด ์šฐ์•„ํ•˜์ง€ ์•Š์„๊นŒ?โ€
  • โ€œํฌ์ธํ„ฐ ์—ฐ์‚ฐ์œผ๋กœ ์ตœ์ ํ™”ํ•ด๋ณด์ž!โ€

์ด๋Ÿฐ โ€˜๋˜‘๋˜‘ํ•ด ๋ณด์ด๋Š” ์ฝ”๋“œโ€™๋Š” ๊ฐ€๋…์„ฑ์„ ํ•ด์น˜๊ณ  ์œ ์ง€๋ณด์ˆ˜ ์ง€์˜ฅ์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
๊ฒŒ๋‹ค๊ฐ€ ์„ฑ๋Šฅ ํ–ฅ์ƒ๋„ ๋Œ€๋ถ€๋ถ„ ์ฒด๊ฐ ๋ถˆ๊ฐ€. ์ตœ์ ํ™”๋Š” ์ปดํŒŒ์ผ๋Ÿฌ๊ฐ€ ์ž˜ ํ•ด์ฃผ๊ณ , API ์ฝœ ํ•œ ๋ฒˆ์— ๋ถ™๋Š” ๋ช‡ ๋‚˜๋…ธ์ดˆ ์ ˆ์•ฝ์€ ์‚ฌ์šฉ์ž์—๊ฒŒ ์˜๋ฏธ ์—†์Šต๋‹ˆ๋‹ค.

๐Ÿ‘‰ ์›์น™: ์ฝ๋Š” ์‚ฌ๋žŒ์ด ํ•œ ๋ฒˆ์ด๋ผ๋„ ๋ฉˆ์นซํ•œ๋‹ค๋ฉด, ์ฐจ๋ผ๋ฆฌ ํ’€์–ด์„œ ์“ฐ๋Š” ๊ฒŒ ๋‚ซ๋‹ค.


2. ๐Ÿ—‘๏ธ โ€œ์ฝ”๋“œ๋ฅผ ๋ฒ„๋ฆฌ๊ธฐโ€๋ฅผ ๋‘๋ ค์›Œํ•จ

  • ๋งŽ์€ ๊ฐœ๋ฐœ์ž๊ฐ€ ๊ธฐ์กด ์ฝ”๋“œ๋ฅผ ๋ถ™์žก๊ณ  ๋์—†์ด ํ•ซํ”ฝ์Šค์™€ ํ•ดํ‚น์„ ๋ง๋Œ€๋ฉฐ โ€œํ”„๋ž‘์ผ„์Šˆํƒ€์ธ ์ฝ”๋“œโ€๋ฅผ ๋งŒ๋“ค์–ด๋ƒ…๋‹ˆ๋‹ค.
  • ๊ทธ๋Ÿฌ๋‚˜ ์ฝ”๋“œ ์ดˆ๊ธฐํ™” โ†’ ์žฌ์ž‘์„ฑ์€ ์ƒ๊ฐ๋ณด๋‹ค ์ฆ๊ฒ๊ณ  ํšจ์œจ์ ์ผ ๋•Œ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค.

๐Ÿ‘‰ ์›์น™: ์นจ๋ชฐ๋น„์šฉ(sunk cost) ์— ๋งค๋ชฐ๋˜์ง€ ๋ง ๊ฒƒ. โ€œ๊ณผ๊ฐํžˆ ์ง€์šฐ๊ณ  ๋‹ค์‹œ ์‹œ์ž‘โ€ํ•  ์ˆ˜ ์žˆ๋Š” ์šฉ๊ธฐ ํ•„์š”.


3. ๐Ÿ—๏ธ ์กฐ๊ธฐ ์ถ”์ƒํ™” (Premature Abstraction)

  • โ€œ์•ž์œผ๋กœ ํ•„์š”ํ• ์ง€๋„ ๋ชฐ๋ผโ€ ํ•˜๋ฉฐ ์กฐ๊ธฐ์— ์ถ”์ƒํ™”/๊ณตํ†ตํ™”๋ฅผ ๋„์ž…ํ•˜๋Š” ๊ฒฝ์šฐ.
  • ๊ฒฐ๊ณผ์ ์œผ๋กœ ์“ธ๋ฐ์—†์ด ๋ณต์žกํ•œ ๊ณ„์ธต๋งŒ ๋‚จ์Šต๋‹ˆ๋‹ค.

์†Œํ”„ํŠธ์›จ์–ด๋Š” ๋ฆฌํŒฉํ„ฐ๋ง ๋น„์šฉ์ด ๋งค์šฐ ์ €๋ ดํ•ฉ๋‹ˆ๋‹ค. ํ”ผ์‚ฌ์˜ ์‚ฌํƒ‘์ด๋‚˜ ํ—ˆ๋ธ” ์šฐ์ฃผ๋ง์›๊ฒฝ์ฒ˜๋Ÿผ ๊ณ ์น˜๊ธฐ ํž˜๋“  ๊ตฌ์กฐ๋ฌผ์ด ์•„๋‹™๋‹ˆ๋‹ค.

๐Ÿ‘‰ ์›์น™: ์ง€๊ธˆ ๋‹น์žฅ ํ•„์š”ํ•œ ์ฝ”๋“œ๋งŒ ์ž‘์„ฑ. DRY(Donโ€™t Repeat Yourself) ๋ณด๋‹ค WET(Write Everything Twice) ๊ฐ€ ๋” ๋‚˜์„ ๋•Œ๋„ ๋งŽ๋‹ค.


4. ๐ŸŒ ๋ถ„์‚ฐ ์‹œ์Šคํ…œ์˜ ๋ณต์žก์„ฑ์„ ์–•์žก์•„๋ด„

  • ๋งŽ์€ ํŒ€์ด ์กฐ๊ธฐ์— ๋ฉ”์‹œ์ง€ ํยท๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค๋ฅผ ๋„์ž…ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ทธ๋Ÿฐ๋ฐ ์ •์ž‘ ๊ฒช๋Š” ์žฅ์• ๋“ค์€ ๋Œ€๋ถ€๋ถ„ ํ ์ž์ฒด ๋ฌธ์ œ:
    • ๋ฉ”์‹œ์ง€ ์ค‘๋ณต/์žฌ์‹œ๋„ ํญ์ฃผ
    • ํ ์šฉ๋Ÿ‰ ์ดˆ๊ณผ
    • DLQ(dead letter queue) ์ฒ˜๋ฆฌ ๋ˆ„๋ฝ

์ฆ‰, ์ƒˆ๋กœ์šด ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๊ธฐ๋ณด๋‹ค ๋ฌธ์ œ ์˜์—ญ๋งŒ ํ™•์žฅํ•œ ์…ˆ์ž…๋‹ˆ๋‹ค.

๐Ÿ‘‰ ์›์น™: ์ง„์งœ ํ•„์š”ํ•  ๋•Œ๋งŒ ๋ถ„์‚ฐ ์•„ํ‚คํ…์ฒ˜ ๋„์ž…. ๊ทธ ์ „์—๋Š” ์Šค๋ ˆ๋”ฉยท์ธ๋ฉ”๋ชจ๋ฆฌ ํยท๋ณ‘๋ ฌํ™” ๊ฐ™์€ ๊ฐ„๋‹จํ•œ ํ•ด๋ฒ•์„ ๋จผ์ € ๊ณ ๋ ค.


5. ๐Ÿ™‹ ๋„์›€ ์š”์ฒญ์„ ๋ฏธ๋ฃจ๋Š” ์Šต๊ด€

  • ๋งŽ์€ ๊ฐœ๋ฐœ์ž๊ฐ€ ๋๊นŒ์ง€ ํ˜ผ์ž ํ•ด๊ฒฐํ•˜๋ ค๊ณ  ํ•จ.
  • ํ•˜์ง€๋งŒ ๊ฐ€์žฅ ํฐ ํ•™์Šต์€ โ€˜์งˆ๋ฌธ ํ›„ ๋Œ€ํ™”โ€™ ๊ณผ์ •์—์„œ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.
    • โ€œ๊ทธ๊ฑฐ ์ด๋ฏธ ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์— ์žˆ์–ด์š”.โ€
    • โ€œ์ด๊ฑด ๋” ์ผ๋ฐ˜ํ™”๋œ ๋ฌธ์ œ์˜ ํŠน์ˆ˜ ์ผ€์ด์Šค์˜ˆ์š”.โ€
    • โ€œํ•ด๊ฒฐ์ฑ…์€ ์ด๋ ‡๊ณ , ๊ด€๋ จ ๊ฐœ๋…๋„ ๊ฐ™์ด ์•Œ๋ ค์ค„๊ฒŒ์š”.โ€

๐Ÿ‘‰ ์›์น™: โ€œ์Šค์Šค๋กœ ํ•ด๊ฒฐ โ†’ ๊ณต์œ /ํ† ๋ก  โ†’ ์˜ˆ์ƒ ๋ชปํ•œ ์ธ์‚ฌ์ดํŠธ ํš๋“โ€์˜ ๋ฃจํ”„๋ฅผ ์˜์‹์ ์œผ๋กœ ๋งŒ๋“ค ๊ฒƒ.


โœ… ์ •๋ฆฌ

Ken์ด ๊ผฝ์€ 5๋Œ€ ํ’‹๊ฑด์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:

  1. ๋˜‘๋˜‘ํ•œ ์ฝ”๋“œ ์“ฐ๊ธฐ โ†’ ๋ช…ํ™•ํ•œ ์ฝ”๋“œ๋กœ ๋Œ€์ฒดํ•˜์ž.
  2. ์ฝ”๋“œ๋ฅผ ๋ฒ„๋ฆฌ์ง€ ๋ชปํ•จ โ†’ ๊ณผ๊ฐํžˆ ์ƒˆ๋กœ ์‹œ์ž‘ํ•˜์ž.
  3. ์กฐ๊ธฐ ์ถ”์ƒํ™” โ†’ ๋ฆฌํŒฉํ„ฐ๋ง์ด ํ›จ์”ฌ ์‹ธ๋‹ค.
  4. ๋ถ„์‚ฐ ์‹œ์Šคํ…œ์„ ๊ฐ€๋ณ๊ฒŒ ์ƒ๊ฐํ•จ โ†’ ํ•„์š”ํ•  ๋•Œ๋งŒ ๋„์ž….
  5. ์งˆ๋ฌธ์„ ๋ฏธ๋ฃจ๊ธฐ โ†’ ๋ฐฐ์›€์˜ ๊ธฐํšŒ๋ฅผ ๋†“์นœ๋‹ค.

๐Ÿ’ก ๋งˆ๋ฌด๋ฆฌ

์ด ํ’‹๊ฑด๋“ค์€ ๋Œ€๋ถ€๋ถ„ โ€œ๊ฐœ๋ฐœ์ž์˜ ์ž์กด์‹ฌโ€๊ณผ ์—ฐ๊ฒฐ๋œ ํ•จ์ •์ž…๋‹ˆ๋‹ค.

  • ๋˜‘๋˜‘ํ•ด ๋ณด์ด๊ณ  ์‹ถ์€ ๋งˆ์Œ,
  • ์“ด ์ฝ”๋“œ์— ๋Œ€ํ•œ ์• ์ฐฉ,
  • ๋ฏธ๋ฆฌ ๋Œ€๋น„ํ•˜๋ ค๋Š” ๋ณธ๋Šฅ,
  • ๋ฉ‹์ ธ ๋ณด์ด๋Š” ์•„ํ‚คํ…์ฒ˜์˜ ์œ ํ˜น,
  • ํ˜ผ์ž์„œ ํ•ด๊ฒฐํ•˜๊ณ  ์‹ถ์€ ์ž์กด์‹ฌ.

๊ทธ๋Ÿฌ๋‚˜ ์žฅ๊ธฐ์ ์œผ๋กœ๋Š” ๋‹จ์ˆœํ•จยท์œ ์—ฐํ•จยทํ˜‘์—…์ด ๋” ํฐ ํž˜์„ ๋ฐœํœ˜ํ•ฉ๋‹ˆ๋‹ค.


์›๋ฌธ - https://kenkantzer.com/5-software-engineering-foot-guns/

profile
Tech Archive 2026

0๊ฐœ์˜ ๋Œ“๊ธ€